Skip to main content
PATCH
设置项目支出限额
本接口要求 Admin Key 具备 org:write 作用域,且调用时 key 持有者仍是组织管理员(否则返回 403 owner_not_admin)。两个字段都不传(空请求体 {})会返回 400 invalid_request,请至少提供一个字段。

三态字段与周期规则

  • 字段省略:保持该周期当前值;null:清除该周期预算(恢复不限);数值:设置该周期预算。
  • 日/月两个周期独立设置、互不影响;响应返回两个周期的完整配置。
  • 预算口径同「查询项目消费预算」页:日按 Asia/Shanghai 自然日、月按自然月重置;超出预算不阻断调用、超出部分仍计费(支出限额用于支出管理与消费占比展示,非强制刹车)。

授权

Authorization
string
header
必填

Authorization 请求头携带 Admin API secret 作为 Bearer 令牌,格式为 Bearer sk-admin-***。Admin Key 可在「控制台 → 组织管理 → Admin API Keys」创建。

路径参数

pid
string
必填

项目 ID。

请求体

application/json

至少提供一个字段。

daily_consume_limit
integer<uint64> | null

日支出限额(毫分)。不传本字段表示保持当前值;传 null 表示清除限额(不限);传数值表示设置新限额。

必填范围: x >= 0
monthly_consume_limit
integer<uint64> | null

月支出限额(毫分)。不传本字段表示保持当前值;传 null 表示清除限额(不限);传数值表示设置新限额。

必填范围: x >= 0

响应

更新后的消费预算。

daily_consume_limit
integer<uint64> | null
必填

日支出限额(毫分)。按 Asia/Shanghai 自然日累计重置;超出预算不阻断调用、超出部分仍计费(预算用于支出管理与占比展示,非强制刹车)。null 表示未设置(不限),0 表示预算为 0(仅展示超支)。

必填范围: x >= 0
monthly_consume_limit
integer<uint64> | null
必填

月支出限额(毫分)。按 Asia/Shanghai 自然月累计重置;超出预算不阻断调用、超出部分仍计费(预算用于支出管理与占比展示,非强制刹车)。null 表示未设置(不限),0 表示预算为 0(仅展示超支)。

必填范围: x >= 0