Skip to main content
管理 API 密钥与护栏策略之间的 1:1 绑定关系。此处强制执行严格的“显式选择加入”约定:传入 policy_id: null 会清除绑定,该密钥随即恢复为不受任何护栏约束的状态——不会自动回退到组织或用户的默认策略。

身份验证

需要携带具有 billing API 密钥权限范围的 Bearer 令牌,并具备对该密钥的访问权限(调用方必须是该密钥的所有者,或者——对于团队密钥——通过所属组织获得访问权限)。

GET

读取当前绑定。

PUT

设置或清除绑定。
string
策略 UUID。传入 null 可完全清除该绑定。

范围规则

  • 个人策略只能绑定到其作者本人拥有的密钥。
  • 团队策略只能绑定到同一组织内的密钥。
  • 跨越该边界会返回 400 guardrail_policy_not_bindable,并附带厂商中立的错误消息。

错误

  • 400 guardrail_policy_not_bindable —— 该策略在此密钥的范围内不可见。
  • 404 not_found —— 密钥或策略不存在(或对调用方不可见)。