XBOX_ 環境變數,或以 xbox context set 儲存的值取得其遊戲、賣方或沙箱。會變更內容的命令會在 stderr 上指出您未在其命令列上傳遞的每個值,因此請在進行生產變更之前檢查這些值。請參閱內容。
哪些是唯讀的
只有名稱以Get、List 或 Search 開頭的 PlayFab 作業才是唯讀的,例如 /Admin/GetTitleData 或 /MultiplayerServer/ListBuildSummariesV2。其他所有作業都會變更內容。這對 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 結束。請勿再次執行它們;如需如何繼續等候,請參閱該命令的頁面。