Skip to main content
POST
Get Usage Configuration

概述

获取你的组织中实际生效的用户级附加额度上限。上限始终按用户设置。响应返回的是合并更大范围作用域的配置后,对请求指定的主体强制执行的上限,而不只是直接在请求指定的作用域中配置的上限。

请求

string
必填
你的服务密钥,需具有“Billing Read”权限

作用域配置 (任选其一)

boolean
设置为 true 可获取团队级的每用户上限
string
提供组 ID,即可获取指定组的有效每用户上限。结果会将团队级上限与该组的覆盖设置 (如有) 合并,但不会考虑用户可能所属的其他组,也不会考虑用户级覆盖设置。
string
提供用户的电子邮件地址,即可获取指定用户的有效每用户上限。结果会合并团队级上限、该用户所属所有组的覆盖设置,以及用户级覆盖设置 (如有) 。
你必须提供 team_level、group_id 或 user_email 三者之一来指定作用域。

示例请求 - 获取团队级每用户上限

示例请求 - 获取组的有效每用户上限

示例请求 - 获取用户的有效每用户上限

响应

integer
所请求对象实际生效的附加额度上限。对于组和用户作用域,此值可能继承自更高层级的作用域。如果响应中未包含此字段,则所请求的作用域及其继承来源的所有作用域均未设置上限。
此端点不会指明返回的上限来自哪个作用域。即使所请求的作用域未配置覆盖设置,针对组或用户的 query 也可能返回继承自团队的上限 (对于用户,也可能继承自其所属的某个组) 。

示例响应 - 上限已生效

响应示例 - 当前无有效上限

错误响应

常见错误场景:
  • 服务密钥无效或权限不足
  • 提供了多个作用域参数
  • 未提供作用域参数
  • 组 ID 或用户邮箱无效
  • 超出速率限制