メインコンテンツへスキップ
リリース間でコマンドがどの程度変更される可能性があるかは、CLI のバージョンと、ヘルプでそのコマンドに [Experimental] ラベルが付いているかどうかによって決まります。コマンド グループに付いたラベルは、そのグループ内の すべてのコマンドに適用されます。

1.0 より前

1.0 リリースまでは XBOX CLI はプレビュー段階であり、試験段階 (Experimental) のラベルの有無にかかわらず、 どのコマンドもリリース間で変更または削除される可能性があります。これには、コマンドのパス、 引数、オプション、既定値、構造化された出力、終了コードが含まれます。自動化では、テスト済みの CLI バージョンに固定し、アップグレードする前にワークフローをテストしてください。

1.0 以降

1.0 リリース以降、試験段階 (Experimental) のラベルが付いていないコマンドは、ドキュメントに記載された 契約を維持します。自動化を壊す変更は、破壊的変更であることを明記したリリースでのみ行われます。 この契約の対象は次のとおりです。
  • コマンドとサブコマンドのパス。
  • 引数とオプションの名前と意味。
  • 必須の入力。
  • ドキュメントに記載された既定値。
  • ドキュメントに記載された JSON 出力 (フィールド名と意味を含む)。
  • ドキュメントに記載された終了コード。
新しいコマンド、オプション、JSON プロパティはどのリリースでも追加される可能性があるため、スクリプトでは 認識できない JSON プロパティを無視する必要があります。テキストやテーブルなど、人が読むための出力は 契約の対象外です。

API パススルー

xbox playfab api のように、コマンドがサービスのレスポンスをそのまま返す場合、その レスポンスは CLI ではなく、サービス自体の互換性の契約に従います。CLI の入力、 終了コード、および CLI が追加する出力 (--data-only で削除されるレスポンス エンベロープなど) は、 引き続き契約の対象です。

試験段階

試験段階 (Experimental) のコマンドは、インターフェイスに関するフィードバックを得るためにリリースされています。1.0 以降も、 パス、オプション、既定値、出力、動作が変更されたり、コマンドが削除されたりする可能性があるため、 これらを使用する自動化が互換性を保ち続けることを前提にしないでください。 試験段階のコマンドは完成しテスト済みであり、破壊的な操作の前の確認を含め、他のすべてのコマンドと同じ セキュリティと安全性のルールに従います。他のコマンドと同じように実行でき、 有効にする必要はありません。
最終更新日 2026年11月19日