XBOX_ 環境変数、または
xbox context set で保存された値から取得します。何かを変更するコマンドは、コマンド ラインで渡されなかった
各値を stderr に示すため、運用環境の変更を行う前に確認してください。
コンテキストを参照してください。
読み取り専用の操作
PlayFab の操作が読み取り専用なのは、/Admin/GetTitleData や /MultiplayerServer/ListBuildSummariesV2 のように、
名前が Get、List、または Search で始まる場合のみです。それ以外のすべての操作は
何かを変更します。これが特に重要になるのは、コマンド名ではなく操作のパスを入力する
xbox playfab api <api-path> です。
コマンドのヘルプには SAFETY セクションがあり、そのコマンドが読み取りを行うか変更を行うかが記載されています。
最初に確認を求めるコマンド
何かを変更するほとんどのコマンドは、確認を求めずに実行されます。次のコマンドは、ターミナルでは最初に確認を求め、 ターミナルがない場合は、--confirm (--yes、-y) を渡さない限り実行を拒否します。
コマンド名からはわからない処理
playfab service-principal setが失敗すると、setが成功するまで、 サービス プリンシパルがスタジオでアクセス権を持たない状態になる可能性があります。その場合、そのサービス プリンシパルとして サインインするパイプラインが停止することがあります。--expected-versionを渡すと、他のユーザーの変更を上書きする代わりにsetが失敗するようになります。playfab privacy exportは、プレイヤーがプレイしたパブリッシャーの すべてのタイトルからプレイヤーのデータを集め、タイトルの通知用メール アドレスにメールで送信します。エクスポート とそのメールは取り消すことができません。- 別のサンドボックスからの
xbl config publishは、公開先のグローバル タイトル ストレージ ファイルを公開元のファイルで置き換え、公開先にのみ存在するファイルを 削除します。削除されたファイルは復元できません。 xbl config publish --sandbox-id HIDDENは、RETAIL を含むすべてのサンドボックスで使用される、 タイトル全体の構成を公開します。
中断された書き込みは結果が不明であることを報告する
CLI が変更を送信した後に、Ctrl+C、タイムアウト、接続の切断などによって変更が中断された場合や、 サービスが HTTP 5xx エラーを返した場合は、変更が適用されている可能性があります。 コマンドは、次の PlayFab エラーのように、結果が不明であることを示します。
変更を再度実行する前に、影響を受ける状態を読み取ってください。
playfab 以外のコマンドは、確認に使用できる
読み取り専用のコマンドを出力します。CLI が変更を自動的に再試行することはありません。
ジョブを待機する一部のコマンドは、リクエストが受け付けられたものの待機が終了した場合に 4 で終了します。
再度実行しないでください。待機を続ける方法については、そのコマンドのページを参照してください。