跳轉到主要內容
命令在各版本之間可以變更的程度,取決於 CLI 的版本,以及說明是否將該命令標示為 [Experimental]。命令群組上的標籤會套用至其中的每個命令。

1.0 之前

在 1.0 版本之前,XBOX CLI 處於預覽階段,任何命令都可能在各版本之間變更或移除,無論它是否標示為實驗性。這包括其路徑、引數、選項、預設值、結構化輸出和結束代碼。若用於自動化,請固定使用經過測試的 CLI 版本,並在升級之前測試您的工作流程。

從 1.0 開始

從 1.0 版本開始,未標示為實驗性的命令會遵守其記載的合約。會中斷自動化的變更只會出現在明確指出為中斷性變更的版本中。合約涵蓋:
  • 命令和子命令路徑。
  • 引數和選項的名稱及意義。
  • 哪些輸入為必要項目。
  • 記載的預設值。
  • 記載的 JSON 輸出,包括欄位名稱及意義。
  • 記載的結束代碼。
新的命令、選項和 JSON 屬性可能出現在任何版本中,因此您的指令碼必須忽略無法辨識的 JSON 屬性。為人員撰寫的輸出 (例如文字和表格) 不屬於合約的一部分。

API 傳遞

當命令按原樣傳回服務的回應時 (如 xbox playfab api 所做的),該回應會遵循服務本身的相容性合約,而不是 CLI 的合約。CLI 的輸入、結束代碼,以及它所加入的輸出 (例如 --data-only 會移除的回應信封) 仍在涵蓋範圍內。

實驗性

實驗性命令的發行目的是取得對其介面的意見反應。即使在 1.0 之後,其路徑、選項、預設值、輸出和行為仍可能變更,或命令可能被移除,因此不要依賴使用這些命令的自動化會維持相容。 實驗性命令已完成且經過測試,並遵循與其他所有命令相同的安全性和安全規則,包括在破壞性作業之前要求確認。它們的執行方式與其他命令相同;您不需要開啟它們。
最後修改於 2026年11月19日