playfab mps コマンド ファミリーは試験段階 (Experimental) です。CLI インターフェイスは、フィードバックに基づいて変更または
削除される可能性があります。
playfab mps は、PlayFab のマルチプレイヤー サーバー (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 コマンドは、確認を求めずに
実行されます。安全性と破壊的な操作を参照してください。
ページング
次の list コマンドは、呼び出しごとに結果を 1 ページ返します。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 で返されるまで繰り返します。1 ページに含める結果の数を変更するには、リクエスト本文で
"PageSize" を設定します。
ビルドの最初のページを取得します。
SkipToken が null でない場合は、そのトークンを渡して次のページを取得します。
SkipToken の列がないため、さらに結果がある場合は、テーブルの後に、
送信するトークンを含む通知が stderr に出力されます。
テーブル出力
次の表に示すコマンドは--output table を受け付けます。その他の MPS コマンドは受け付けません。
テーブル出力を参照してください。
単一のレコードを返すコマンドは、そのレコードを 1 行で表示します。
マスクされた列の値は資格情報であるため、
******** と表示されます。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 を使用すると値がシェルの履歴やプロセスの一覧に残るため、--body は拒否されます。
どちらのコマンドも --output table を受け付けません。
ForceUpdate を指定すると、同じ名前の既存の証明書またはシークレットが置き換えられます。本文ファイルは
ソース管理に含めず、アップロードが完了したら削除してください。
certificate.json には、Base64 でエンコードされた PFX とそのパスワードが含まれます。
--body-file - にパイプします。
この例では、jq は自身の引数ではなく api-key.txt から値を読み取るため、
値はプロセスの一覧に表示されません。
mps asset upload
asset upload は、ローカル ファイルをマルチプレイヤー サーバーのアセットとしてアップロードします。リクエスト本文ではなく
オプションを受け取り、アセット名とアップロードの状態を JSON として書き込みます。
