用户 ACU 上限 - Devin Docs

本文档适用于 Devin 联邦部署。返回 Devin 文档

读取和管理用户级 ACU 上限覆盖。用户级覆盖的优先级高于团队和组限额；有关生效上限的解析方式，请参阅 ACU 限制。这些端点仅适用于多租户联邦部署。读取操作需要 Teams Read-Only 权限，写入操作需要 Teams Update 权限。两个端点均通过 user 对象指定用户，该对象必须且只能包含以下其中一项：

string

用户的电子邮件地址。

string

用户的稳定 ID，由 API 返回 (例如在组成员或 ACU 消耗记录中) 。

组作用域的服务密钥只能选择其分配组中的当前成员；其他用户会返回 not_found。有关身份验证和错误的信息，请参阅 API 概述。两个端点返回的上限对象：

字段	说明
`user_id`	用户的稳定 ID。
`email`	用户的电子邮件地址。
`configured_cycle_acu_limit`	直接设置的用户级覆盖 (如有) 。值为 `0` 表示该用户被阻止。未设置覆盖时省略。
`effective_cycle_acu_limit`	结合用户级覆盖、团队和组限额后，实际对该用户执行的上限。未应用任何限制时省略。

获取用户的 ACU 上限

POST /api/v1/GetUserAcuCap

curl -X POST https://<your-server>/api/v1/GetUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"}
  }'

{
  "cap": {
    "userId": "user_abc",
    "email": "dev@agency.gov",
    "configuredCycleAcuLimit": 25,
    "effectiveCycleAcuLimit": 25
  }
}

设置或取消设置用户的 ACU 上限

POST /api/v1/UpdateUserAcuCap

必须且只能提供以下其中一项：

number

设置用户每个周期的 ACU 覆盖限额。该值必须为非负数；0 表示阻止该用户消耗任何 ACU。

boolean

移除用户的覆盖设置，使 Team 和组限额重新生效。

curl -X POST https://<your-server>/api/v1/UpdateUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"},
    "set_cycle_acu_limit": 25
  }'

响应中包含更新后的 cap 对象。

将用户的覆盖值设为 0 会阻止该用户。服务密钥组 API 不接受组上限为零：set_cycle_acu_limit 必须为正数，而 clear_cycle_acu_limit 会移除组覆盖设置。门户中独立的组上限操作会将 0 视为清除操作。请参阅零值和未设置值。

​获取用户的 ACU 上限

​设置或取消设置用户的 ACU 上限

获取用户的 ACU 上限

设置或取消设置用户的 ACU 上限