跳转到主要内容
读取和更新游戏的 API 访问策略,即控制哪些调用方可以使用哪些 PlayFab API 的语句。错误的策略可能会将所有玩家锁定在游戏之外。你需要对该游戏拥有 Admin 权限;请参阅 PlayFab 身份验证的工作原理。 api-policy 命令不接受 --output table。

添加语句

读取当前策略及其版本:
将要添加的语句放入文件中。此 policy.json 拒绝所有调用方使用 Server API 的 DeleteCharacterFromUser:
  • Resource 是 pfrn:api-- 加上 API 路径,或者是表示所有 API 的 pfrn: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日