ユーザー ACU 上限

このドキュメントは Devin の連邦政府向け導入環境用です。Devin Docs に戻る

ユーザーごとの ACU 上限オーバーライドを確認・管理します。ユーザーオーバーライドはチームおよびグループの上限より優先されます。有効な上限の決定方法については、ACU 上限を参照してください。これらのエンドポイントは、マルチテナントの連邦政府向け導入環境でのみ利用できます。読み取りには Teams Read-Only、書き込みには Teams Update を使用します。両方のエンドポイントでは、次のいずれか 1 つのみを含む user オブジェクトでユーザーを指定します。

string

ユーザーのメールアドレス。

string

API から返されるユーザーの永続 ID (たとえば、グループメンバーまたは 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

次のいずれか1つを必ず指定してください。

number

ユーザーごとの1サイクルあたりのACU上限のオーバーライドを指定します。0以上である必要があります。0 を指定すると、ユーザーはACUを一切消費できなくなります。

boolean

ユーザーのオーバーライドを削除し、チームおよびグループの上限が再び適用されるようにします。

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上限を設定またはクリアする