> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ユーザーレベルのACU上限

> ティア、IdPグループマッピング、ユーザーオーバーライドを使用して、各ユーザーの月間ACU消費量を制限します

<Note>
  ユーザーレベルの上限はベータ機能であり、Enterpriseでこの機能を有効にする必要があります。有効にするには、アカウントチームにお問い合わせください。
</Note>

ユーザーレベルの上限では、ユーザーの**ローカルとクラウド**のACU使用量の合計を制限します。cloud Devin セッション、Devin Desktop、Windsurf JetBrains、Devin CLIはすべて同じ上限にカウントされます。ユーザーが上限に達すると、上限が引き上げられるか、次の月次期間に使用量がリセットされるまで、これらの対象で新しい作業を開始できません。

ティアとユーザーレベルの上限は、web appの**Enterprise Settings**にある**使用量ポリシー** ([使用量ポリシーガイド](/ja/enterprise/features/usage-policies)を参照) 、または以下の[usage-policiesエンドポイント](#tier-endpoints)で管理できます。

ユーザーレベルの上限は**ティア**で管理します。ティアは、メンバー間で共有される名前付きのアカウント全体のデフォルト上限です。

* ユーザーがティアに属する方法は3つあります。adminによる**明示的な割り当て**、[**IdPグループマッピング**](#idp-group-endpoints)による割り当て (グループはティアにマッピングされ、メンバーは明示的に別のティアに割り当てられない限り、そのティアを継承します) 、または**デフォルトティア**へのフォールバックです。各アカウントでは、1つのティアをデフォルトティアとして指定できます。他のティアに割り当てられていないすべてのアカウントメンバーは、そのティアに属します。個別の「デフォルトユーザー上限」はありません。代わりにデフォルトティアを設定してください。
* 個々のユーザーには、**永続的** (期限なし) または**一時的** (現在の月次請求期間の終了時に失効) の**ユーザーオーバーライド**を設定できます。ユーザーオーバーライドはユーザー単位であり、設定してもユーザーのティア割り当ては変更されません。
* ユーザーの**実効上限**は、次の順序で決まります。永続的なオーバーライド、有効な一時的オーバーライド、明示的に割り当てられたティアの`cycle_acu_limit`、最上位のIdPグループマッピング済みティアの上限、デフォルトティアの上限です。上限が`null`の場合は上限がないことを意味します。
* ユーザーは上限の引き上げをリクエストできます。adminはこれらの[**上限引き上げリクエスト**](#limit-increase-request-endpoints)を確認します。各ティアの`policy`により、リクエストを自動承認するか、手動レビューに回すかが決まります。

ユーザーレベルの上限は[組織レベルの上限](/ja/admin/billing/org-acu-limits)とは独立しており、どちらかの上限に達している場合はリクエストがブロックされます。このページのすべてのエンドポイントに共通する認証、権限、`PATCH`のセマンティクスについては、[ACU上限](/ja/admin/billing/acu-limits)を参照してください。

<Warning>
  ティア導入前のユーザーごとの上限およびデフォルトユーザー上限エンドポイントは非推奨です。[レガシーユーザーACU上限エンドポイント](/ja/admin/billing/legacy-user-acu-limits)を参照してください。
</Warning>

<div id="tier-endpoints">
  ## ティアエンドポイント
</div>

<div id="list-tiers">
  ### ティアの一覧を取得
</div>

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers
```

優先順位順にページ分割されたティアのリストを返します。`priority` が最も高いものから順に、同じ優先順位内では最も新しいティアから順に返されます。各ティアは次のとおりです。

```json theme={null}
{
  "tier_id": "tier-abc123",
  "name": "Engineers",
  "is_default": true,
  "cycle_acu_limit": 500,
  "policy": "manual",
  "max_limit": null,
  "priority": 0,
  "member_count": 42,
  "created_at": 1735689600
}
```

* `is_default`: アカウントのデフォルトティアかどうか。
* `cycle_acu_limit`: 各メンバーのサイクルあたりのデフォルトACU上限。`null` は上限がないことを意味します。
* `policy`: ティアに対する上限引き上げリクエストの処理方法。`unconditional` と `conditional` は `max_limit` まで承認し、`manual` では管理者によるレビューが必要です。`conditional` ポリシー (効率性に基づく自動承認) を利用するには、別途有効化が必要です。アカウントチームにお問い合わせください。
* `max_limit`: 引き上げリクエストが承認される最大上限。`null` は上限なしで承認されることを意味します。`cycle_acu_limit` が `null` の場合は常に `null` です。
* `priority`: ユーザーのIdPグループマッピングによるティア間の優先順位。値が最も高いティアが優先され、同値の場合は最も新しいティアが優先されます。この順位付けは優先順位のみを示すものであり、優先順位が高いティアの `cycle_acu_limit` が低い場合があります。明示的なユーザー割り当てはこの優先順位を上書きし、デフォルトティアは優先順位付けの対象になりません。
* `member_count`: 現在ティアに含まれるユーザー数。明示的に割り当てられたユーザーと、IdPグループマッピングによって割り当てられたユーザーの合計です。デフォルトティアでは、他のティアに含まれないすべてのアカウントメンバーがカウントされます。

<Note>
  web appの**使用量ポリシー**で、デフォルトティアとティアの優先順位を設定します。
</Note>

<div id="create-a-tier">
  ### ティアを作成する
</div>

```http theme={null}
POST /v3beta1/enterprise/usage-policies/tiers
```

**リクエストボディ**

```json theme={null}
{
  "name": "Engineers",
  "cycle_acu_limit": 500,
  "policy": "manual"
}
```

アカウントで最初に作成されたティアが自動的にデフォルトティアになります。作成されたティアを含む HTTP `201` を返します。

<div id="get-a-tier">
  ### ティアを取得する
</div>

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

<div id="update-a-tier">
  ### ティアを更新する
</div>

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

部分更新です。省略したフィールドは変更されません。デフォルトティアまたはティアの優先順位を変更するには、web app の **使用量ポリシー** で設定してください。

```json theme={null}
{
  "name": "Engineering",
  "cycle_acu_limit": 750
}
```

<div id="delete-a-tier">
  ### ティアを削除
</div>

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

成功時は HTTP `204` を返します。デフォルトティアは削除できません (先に別のティアを昇格させてください) 。ユーザーが残っているティアを削除するには、先にユーザーを移動し、そのティアに対する IdP グループマッピングをすべて削除する必要があります。

<div id="tier-user-endpoints">
  ## ティアユーザーのエンドポイント
</div>

<div id="list-a-tiers-users">
  ### ティアのユーザー一覧を取得する
</div>

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users
```

ティアに属するユーザー (明示的に割り当てられたユーザーと、IdPグループマッピングによって追加されたユーザー) およびそれぞれの解決済み上限を、ページネーション形式で返します。デフォルトティアでは、他のティアに属していないすべてのアカウントメンバーが対象です：

```json theme={null}
{
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "cycle_acu_limit_override": null,
  "temporary_cycle_acu_limit": 800,
  "effective_cycle_acu_limit": 800,
  "limit_source": "temporary_override",
  "membership": "explicit"
}
```

* `cycle_acu_limit_override`: ユーザーに設定された永続的なオーバーライド (ある場合) 。
* `temporary_cycle_acu_limit`: ユーザーに設定された一時的なオーバーライド。現在の月次請求期間中に有効な場合にのみ存在します。
* `effective_cycle_acu_limit`: 現在ユーザーに適用されている上限。`null` は上限がないことを示します。
* `limit_source`: 実効上限の適用元 — `override` (永続的) 、`temporary_override`、または `tier`。
* `membership`: ユーザーがティアに属している理由 — `explicit` (直接割り当て) 、`idp_group` (優先される IdP グループマッピング経由) 、または `default` (デフォルトティアへのフォールバック) 。

<div id="assign-a-user-to-a-tier">
  ### ユーザーをティアに割り当てる
</div>

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

冪等です。成功時は HTTP `204` を返します。別のティアからユーザーを移動すると、ユーザーオーバーライドはクリアされ、移動先ティアの limit を継承した状態になります。

<div id="remove-a-user-from-a-tier">
  ### ティアからユーザーを削除する
</div>

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

ユーザーの明示的なティア割り当て (およびオーバーライド) を解除し、デフォルトティアに戻します。成功時は HTTP `204` を返します。

<div id="user-override-endpoint">
  ## ユーザーオーバーライドエンドポイント
</div>

<div id="set-or-clear-a-users-override">
  ### ユーザーのオーバーライドを設定または解除する
</div>

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/users/{user_id}
```

ユーザースコープ: 対象はアカウントメンバーであればよく、ティアは関係しません。ユーザーのティア割り当てが変更されることもありません。明示的なティア割り当てがなく、オーバーライドのみが設定されているユーザーは、デフォルトティアのままです。

**リクエストボディ — 一時的なオーバーライドを設定**

```json theme={null}
{
  "cycle_acu_limit": 800,
  "kind": "temporary"
}
```

`kind` は値を設定する際に必須です。`permanent` は期限切れにならず、`temporary` は現在の月次請求期間の終了時に期限切れになります。

**リクエストボディ — すべてのオーバーライドをクリア**

```json theme={null}
{
  "cycle_acu_limit": null
}
```

エンドポイントは、成功時に HTTP `204` を返します。

<div id="idp-group-endpoints">
  ## IdP グループのエンドポイント
</div>

IdP グループをティアにマッピングすると、そのメンバーにはそのティアが自動的に継承されます。マッピングはグループメンバーシップに基づいてリアルタイムに解決され、ユーザーの明示的なティア割り当てが変更されることはありません。明示的な割り当てが常に優先されます。複数のマッピング済みグループに属するユーザーには、最上位のマッピング済みティアが適用されます (`priority` が最も高いティア。同順位の場合は最も新しいティア) 。

<div id="list-idp-group-mappings">
  ### IdP グループマッピングの一覧
</div>

```http theme={null}
GET /v3beta1/enterprise/usage-policies/idp-groups
```

アカウントのグループとティアのマッピングを、古い順にページ分割して返します。`?tier_id=` でフィルタリングすると、特定のティアにマッピングされたグループのみを一覧表示できます。

```json theme={null}
{
  "idp_group_id": "grp_abc123",
  "idp_group_name": "Engineering",
  "tier_id": "tier-abc123"
}
```

<div id="get-an-idp-groups-mapping">
  ### IdPグループのマッピングを取得
</div>

```http theme={null}
GET /v3beta1/enterprise/usage-policies/idp-groups/{idp_group_name}
```

グループにマッピングがない場合、HTTP `404` を返します。

<div id="map-an-idp-group-to-a-tier">
  ### IdP グループをティアにマッピングする
</div>

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/idp-groups/{idp_group_name}
```

**リクエストボディ**

```json theme={null}
{
  "tier_id": "tier-abc123"
}
```

冪等なアップサートです。グループは1つのティアにのみマッピングできるため、すでにマッピングされているグループをマッピングすると、指定したティアに移動します。

<div id="unmap-an-idp-group">
  ### IdPグループのマッピングを解除する
</div>

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/idp-groups/{idp_group_name}
```

成功時は HTTP `204` を返します。マッピング済みティアはグループのメンバーに適用されなくなります。明示的な割り当てがなく、他にマッピング済みティアもないユーザーには、デフォルトティアが適用されます。

<div id="limit-increase-request-endpoints">
  ## 上限引き上げリクエストのエンドポイント
</div>

ユーザーは、サイクルごとの上限引き上げをリクエストできます。リクエスト者のティアの`policy`によって処理が決まり、`unconditional`と`conditional`ではティアの`max_limit`まで自動承認されます。`manual`では、これらのエンドポイント (または web app の**使用量ポリシー**) を通じて管理者が確認するまで、リクエストは保留されます。

<Note>
  このページの他のエンドポイントとは異なり、上限引き上げリクエストを取得するには **ManageBilling** 権限が必要です。リクエストにはメンバーの識別情報と自由記述メッセージが含まれるため、管理者ワークフローのデータとして扱われます。
</Note>

<div id="list-limit-increase-requests">
  ### 上限引き上げリクエストの一覧を取得する
</div>

```http theme={null}
GET /v3beta1/enterprise/usage-policies/requests
```

ページネーションされた一覧を返します。`?status=` (`pending`、`approved`、`denied`) および`?user_id=`で絞り込めます：

```json theme={null}
{
  "request_id": 42,
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "current_cycle_acu_limit": 500,
  "requested_cycle_acu_limit": 800,
  "message": "Wrapping up a large migration this month",
  "status": "pending",
  "created_at": 1735689600,
  "reviewed_at": null,
  "reviewer": null
}
```

* `tier_id` / `tier_name`: リクエスト者のティア (明示的な割り当て、IdPグループマッピング、またはデフォルトティア) 。accountにティアがない場合は`null`。
* `current_cycle_acu_limit`: リクエスト者に現在適用されている上限。`null`は上限がないことを示します。
* `reviewer`: リクエストをレビューしたAdmin。保留中の場合は`null`です。

<div id="get-a-limit-increase-request">
  ### 上限引き上げリクエストを取得
</div>

```http theme={null}
GET /v3beta1/enterprise/usage-policies/requests/{request_id}
```

<div id="approve-a-limit-increase-request">
  ### 上限引き上げリクエストを承認する
</div>

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/approve
```

リクエストされた上限を、現在の月次請求期間の終了時に失効する**一時的なオーバーライド**として付与します。必要に応じて、異なる上限を付与できます。

```json theme={null}
{
  "cycle_acu_limit": 700
}
```

更新後のリクエストを返します。リクエストがすでに確認済みである場合、またはリクエスト送信者がアカウントメンバーでなくなった場合は、HTTP `409` を返します。

<div id="deny-a-limit-increase-request">
  ### 上限引き上げリクエストを拒否する
</div>

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/deny
```

更新後のリクエストを返します。すでにレビュー済みの場合は、HTTP `409` を返します。

<div id="example-workflows">
  ## ワークフローの例
</div>

<div id="set-up-tiers-with-a-default-limit">
  ### デフォルト上限付きのティアを設定する
</div>

すべてのユーザーに月間500 ACUの上限を適用するデフォルトティアを作成します。

```bash theme={null}
curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/tiers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Standard", "cycle_acu_limit": 500, "policy": "manual"}'
```

上限の高いティアを作成し、ユーザーを割り当てます：

```bash theme={null}
curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/tiers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Power users", "cycle_acu_limit": 2000, "policy": "manual"}'

curl -X PUT "https://api.devin.ai/v3beta1/enterprise/usage-policies/tiers/tier-abc123/users/user_abc123" \
  -H "Authorization: Bearer <token>"
```

月末まで、ユーザーの上限を一時的に引き上げます：

```bash theme={null}
curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/users/user_abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 800, "kind": "temporary"}'
```

IdP グループを上限の高いティアにマッピングし、保留中の上限引き上げリクエストを確認します：

```bash theme={null}
curl -X PUT "https://api.devin.ai/v3beta1/enterprise/usage-policies/idp-groups/Engineering" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"tier_id": "tier-abc123"}'

curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/requests/42/approve" \
  -H "Authorization: Bearer <token>"
```

<div id="frequently-asked-questions">
  ## よくある質問
</div>

<AccordionGroup>
  <Accordion title="ユーザーレベルの上限はどの製品に適用されますか？">
    ローカルとクラウドの使用量: cloud Devin セッションと、CLI および IDE (Devin Desktop、Windsurf JetBrains、Devin CLI) でのローカル使用量は、同一の上限に計上されます。
  </Accordion>

  <Accordion title="ユーザーの実効上限はどのように決まりますか？">
    永続的なオーバーライドが最優先され、次に有効な一時的なオーバーライド、ユーザーに明示的に割り当てられたティアの上限、IdP グループにマッピングされたティアのうち最上位のものの上限、デフォルトティアの上限の順に適用されます。すべてのレベルの上限が `null` の場合、ユーザーに上限はありません。
  </Accordion>

  <Accordion title="ユーザーオーバーライドはティアの上限に加算されますか？">
    いいえ。オーバーライドは、そのユーザーのティア上限を置き換えます。ティア上限が 500 ACU で、ユーザーに 200 ACU のオーバーライドがある場合、そのユーザーの実効上限は 200 ACU です。
  </Accordion>

  <Accordion title="永続的なオーバーライドと一時的なオーバーライドの違いは何ですか？">
    永続的なオーバーライドは期限切れになりません。一時的なオーバーライドは現在の月次請求期間の終了時に失効し、その後はユーザーのティア上限が適用されます。上限引き上げリクエストを承認すると、一時的なオーバーライドが付与されます。
  </Accordion>

  <Accordion title="デフォルトユーザー上限は引き続き存在しますか？">
    独立した設定としては存在しません。代わりにデフォルトティアの上限を設定してください。これは、他のティアに割り当てられていないすべてのアカウントメンバーに適用されます。[レガシーのデフォルトユーザー上限エンドポイント](/ja/admin/billing/legacy-user-acu-limits#default-user-limit-endpoints)では、デフォルトティアの上限を読み書きするようになりました。
  </Accordion>

  <Accordion title="上限に達するとどうなりますか？">
    ローカルとクラウドのどちらでも、新しい作業はブロックされます。ユーザーは Enterprise 管理者に連絡して上限を調整するか、次の月次期間が始まるまで待つことができます。
  </Accordion>
</AccordionGroup>