stable · guide · 0.1.0

Manage Project Client quotas

Authorization boundary

POST /admin/operations/quotas.set 是公開 management contract，但不是一般 Project Credential API。呼叫者必須是 active Platform Operator，具有 quotas responsibility、相符 environment、明確 Project Client scope，以及最近十分鐘內的 recent passkey or recovery-code authentication。每次成功、拒絕或衝突都會留下 constrained Platform Audit。

公開契約不提供 Operator Console procedure、內部告警、逐筆 usage record、其他 Project Client 資料或緊急存取流程。

無有效 Platform Session 時回傳 401；尚未接受目前法律文件時回傳 403。Operator responsibility、Project Client scope、environment、recent strong authentication 或 request validation 不符合時回傳 422，不會洩漏其他 Project Client 的狀態。

Limits and windows

Request 指定 project_client_id，並在 parameters 選擇 resource：

• soft_limit：到達時產生容量提示，但不拒絕工作。
• hard_limit：下一筆會超過時拒絕，不記錄被拒絕的用量。
• window_seconds：60 至 2,678,400 秒；省略時為 3,600 秒。

Soft limit 不可大於 hard limit。任一 limit 可設為 null 以停用該層限制；quota 更新不會授予 capability、scope 或 entitlement。成功回應只有 {"data":{"updated":true}}，不公開當前 usage bucket 或 operational data。