playfab mps 명령 패밀리는 실험적 기능입니다. CLI 인터페이스는 피드백에 따라 변경되거나
제거될 수 있습니다.
playfab mps는 PlayFab Multiplayer Servers(MPS)의 빌드와 그 별칭 및 지역, 서버, 자산,
인증서, 비밀, 컨테이너 이미지, 할당량, 가상 머신(VM)을 관리합니다. PlayFab의
MpsPowershell 모듈과 같은 작업을 다루며, 이 모듈의
Set-PfTitle에 해당하는 것은 xbox context set playfab-title-id <id>입니다. 컨텍스트를 참조하세요.
명령 트리
각 명령은xbox playfab mps 아래에서 실행됩니다.
요청 본문
대부분의 MPS 명령은playfab api처럼 작업의 JSON
요청 개체를 보냅니다.
--body와 --body-file은 함께 사용할 수 없습니다. certificate upload와 secret upload는
--body-file만 사용하며, asset upload는 둘 다 사용하지 않습니다. 해당 섹션을 참조하세요.
파괴적 명령
다음 명령은 터미널에서는 먼저 묻고, 그 밖의 환경에서는--confirm(--yes, -y)이
필요합니다. build delete, build alias delete, build region delete, server shutdown,
asset delete, certificate delete, secret delete,
container-image repository delete, remote-user delete. --body-file -를 사용하면
터미널에서도 --confirm이 필요합니다. 무언가를 변경하는 그 밖의 MPS 명령은 묻지 않고
실행됩니다. 안전 및 파괴적 작업을 참조하세요.
페이징
다음 목록 명령은 호출당 결과의 한 페이지를 반환합니다.build list,build alias listserver list,server list-archivedasset list,certificate list,secret listcontainer-image list,container-image list-tagsvirtual-machine list
SkipToken이 설정됩니다. 다음 페이지를 가져오려면 요청 본문에 그
값으로 "SkipToken"을 추가하고 다른 필드는 유지한 채, SkipToken이 null로 반환될 때까지
반복하세요. 한 페이지에 포함되는 결과 수를 변경하려면 요청 본문에 "PageSize"를 설정하세요.
빌드의 첫 번째 페이지를 가져옵니다.
SkipToken이 null이 아니면 해당 토큰을 전달하여 다음 페이지를 가져옵니다.
SkipToken 열이 없으므로, 결과가 더 있으면 테이블 다음에 보낼 토큰이 포함된
알림이 stderr에 출력됩니다.
테이블 출력
다음 표의 명령은--output table을 허용하며, 그 밖의 MPS 명령은 허용하지 않습니다.
테이블 출력을 참조하세요.
단일 레코드를 반환하는 명령은 레코드를 한 행으로 표시합니다.
가려진 열은 값이 자격 증명이므로
********를 출력합니다. JSON 출력은 실제 값을
반환합니다.
mps build create
build create에는 호출할 PlayFab API를 선택하는 --type이 필요하며, 다른 MPS 명령처럼
요청 본문을 사용합니다.
mps certificate upload 및 mps secret upload
certificate upload와 secret upload는 요청 본문에 PFX 암호나 비밀 값이 들어 있으므로
--body-file <path> 또는 stdin의 경우 --body-file -로만 요청 본문을 받습니다. 셸 기록과
프로세스 목록에 값이 남는 --body는 거부합니다. 둘 다 --output table을 허용하지 않습니다.
ForceUpdate는 같은 이름을 가진 기존 인증서나 비밀을 대체합니다. 본문 파일은 소스 제어에
포함하지 말고, 업로드한 후에는 삭제하세요.
certificate.json에는 Base64로 인코딩된 PFX와 그 암호가 들어 있습니다.
--body-file -로 파이프하세요. 여기서 jq는
자체 인수가 아니라 api-key.txt에서 값을 읽으므로, 값이 프로세스 목록에 나타나지 않습니다.
mps asset upload
asset upload는 로컬 파일을 멀티플레이어 서버 자산으로 업로드합니다. 요청 본문 대신 옵션을
사용하며, 자산 이름과 업로드 상태를 JSON으로 씁니다.
