跳轉到主要內容
讀取及更新遊戲的 API 存取原則,也就是控制哪些呼叫端可以使用哪些 PlayFab API 的陳述式。錯誤的原則可能會將所有玩家鎖在遊戲之外。您需要具備遊戲的 Admin 權限;請參閱 PlayFab 驗證的運作方式。 api-policy 命令不接受 --output table。

新增陳述式

讀取目前的原則及其版本:
將要新增的陳述式放在檔案中。此 policy.json 會對每個呼叫端拒絕 Server API 的 DeleteCharacterFromUser:
  • Resource 為 pfrn:api-- 加上 API 路徑,或以 pfrn:api--* 代表每個 API。
  • Action 為 *,這是 PlayFab 唯一接受的值。
  • Effect 為 Allow 或 Deny。
  • Principal 為 * 以符合每個呼叫端。
  • Comment 是選用的文字,供您自己記錄之用。
  • ApiConditions 為選用,用於設定條件,例如 { "HasSignatureOrEncryption": "True" },其值可為 Any、True 或 False。
欄位名稱不區分大小寫。無法辨識的欄位 (例如拼錯的 ApiConditions) 會視為錯誤,因為捨棄它可能會擴大陳述式所允許的範圍。PlayFab 的 API 存取原則頁面說明了每個欄位,並顯示允許每個 API 的預設原則。 接著新增陳述式,並傳遞 get 所傳回的版本:

取代原則

--overwrite 會以您傳遞的陳述式取代整個原則,並捨棄您未包含的每個陳述式。CLI 無法還原先前的原則,因此請先儲存 get 的輸出。
--overwrite 需要 --confirm,以及在同一個命令上以 --playfab-title-id 指定的遊戲。即使指定了 --confirm,它也會拒絕來自 XBOX_PLAYFAB_TITLE_ID 或已儲存內容的遊戲,並改為列印要執行的命令:
最後修改於 2026年11月19日