ユースケースの例
部門管理者への委任
Acme Corp には 10 の部門があります。各部門長は自部門の組織の上限を管理し、各部門の合計は中央 IT が設定します。この例では、そのうち 2 つの部門を取り上げます。 エンタープライズ管理者の Alice は、Account 予算の下に部門ごとの予算を作成し、それぞれを各部門の管理者と共有します。各部門の管理者は、自部門の組織ごとに予算を作成します。Account 予算の下にある部門予算
- Engineering 部門の管理者である Bob は、Engineering 配下のどの予算にも上限と一時的な上限を設定できます。たとえば、繁忙期の 1 週間だけ Payments に 6,000 ACU の一時的な上限を設定できます。
- Bob は Engineering の上限である 30,000 ACU を引き上げることはできません。引き上げられるのは Alice だけです。
- 各組織の予算の合計が 30,000 ACU を超えていても、Engineering 配下のすべての組織の使用量は 30,000 ACU の上限に算入されます。

部門管理者として表示した予算ページ(Account 予算はロックされています)

部門管理者が子予算の上限を引き上げる様子

部門管理者は部門予算の上限を変更できません
ユーザー上限を引き上げたプロジェクト用の予算枠
すべての開発者には月 200 ACU が割り当てられています。移行プロジェクトのために、Acme Corp は 5,000 ACU を確保し、プロジェクトのメンバーがより多く利用できるようにします。 Developer tools の組織は、200 ACU のデフォルトティアを持つ Developer tools 予算に置いたままにします。上限 5,000 ACU の Migration initiative 予算を作成してプロジェクトの組織を配置し、1,000 ACU のデフォルトティアを設定します。どちらの予算も Account 予算の配下に置かれます。Developer tools 予算と Migration initiative 予算、およびそれぞれのティア
- プロジェクトの開発者である Carol は、Migration 組織では最大 1,000 ACU、Developer tools の組織では最大 200 ACU を利用できます。
- プロジェクト全体での利用量は、1 か月あたり 5,000 ACU を超えることはありません。

複数の予算が表示された「自分の利用状況分析」の予算ピッカー
予算の仕組み
予算ツリー
各エンタープライズアカウントには予算ツリーが1つあります。ルートは Account 予算 で、その下に子予算が配置されます。ツリーは最大3階層まで作成できます。 1つの予算には、1つまたは複数の組織を含めることができます。各組織が属する予算は必ず1つです。新しい組織は Account 予算 の下に配置されます。 たとえば、Acme Corp が Account 予算 に 100,000 ACU の上限を設定し、Engineering がそのプールを3つの子予算に分割するとします。予算とユーザー上限ティアを含む予算ツリー

予算ごとの使用率を示す予算ツリー(モックデータ)
予算の上限
予算の上限は、その予算に属する組織と、子予算に属する組織の ACU 使用量の合計を、月次期間ごとに制限します。上限がnull の場合は無制限です。
- 使用量はすべての祖先予算に計上されます。 子予算での使用量は、その親予算と Account 予算にも計上されます。
- 祖先予算が上限に達すると、その子予算での使用も阻止されます。 経路上のいずれかの予算が上限に達すると、そのブランチでの使用は停止します。
- 子予算の上限の合計は、親予算の上限を超えてもかまいません。 その場合でも、合計使用量は親予算の上限によって制限されます。
- 上限のない予算も、親予算の上限によって制限されます。
予算を使い切った場合
予算を使い切ると、その予算に属する組織では利用が停止されます。いずれかの親予算を使い切った場合も同様に停止されます。利用は次の月次期間に再開されます。また、管理者が上限を引き上げるか、一時的な上限を設定した場合にも再開されます。- Devin セッション: 新しいセッションを開始できなくなり、実行中のセッションはスリープ状態になります。ユーザーには「Increase your organization’s usage limit.」と表示されます。
- Devin CLI およびデスクトップのローカルエージェント: リクエストはブロックされます。ユーザーには「Your organization has reached its monthly usage limit. Ask an account admin to raise it, or wait for the limit to reset next month.」と表示されます。
- Devin Review: フルレビューは実行されなくなります。自動レビューと Devin Review のレビューページから開始したレビューは、検出結果を含まない diff のみの分析にフォールバックします。再実行、API 経由で開始したレビュー、Review チャットは拒否されます。

予算を使い切ったときに表示されるコンポーザーのバナー
月次期間
予算の上限、ユーザーの上限、一時的な上限は、各月次期間の開始時にリセットされます。各期間は請求フェーズの開始日から始まるため、必ずしも暦月とは一致しません。 たとえば、請求フェーズが15日に始まる場合、期間は10月15日〜11月14日、その次は11月15日〜12月14日となります。 一時的な上限は、現在の期間の残りの間、予算の上限に代わって適用されます。次の期間には恒久的な上限に戻ります。一時的なユーザーオーバーライドは、現在の期間の終了時に失効します。
一時的な上限により、この期間に限り Marketing の上限を 6,000 ACU に引き上げた例
予算内のユーザーごとの上限
ユーザーごとの上限は、1 人のユーザーが月次期間内に使用できる量の上限です。組織がリンクされた予算はそれぞれ独自のユーザーごとの上限を持ち、その上限は当該予算内でのみ適用されます。- 階層。 各予算には独自の階層と、1 つのデフォルト階層があります。階層では、そのメンバーの月間 ACU 上限を設定します。
- IdPグループマッピング。 アイデンティティプロバイダーのグループを階層に関連付けます。グループのメンバーには、その階層が適用されます。
- 上書き設定。 特定のユーザーに対して、恒久的または一時的な上限を設定します。
- リクエストポリシー。 上限引き上げリクエストの処理方法は階層ごとに設定します。
unconditionalとconditionalでは、階層のmax_limitまでのリクエストが承認されます。manualでは、リクエストが管理者に送られてレビューされます。 - スコープ。 ユーザーごとの上限の対象となるのは、その予算に属する組織でのユーザーの使用量のみです。
- コピーとクリア。 別の予算またはアカウントから階層をコピーできます。IdPグループマッピング、割り当て、上書き設定もコピーできます。予算内の階層をすべてクリアして、一から設定し直すこともできます。

ソースとして Developer tools を選択した、使用量ポリシーのコピーダイアログ
予算を管理できるユーザー
Enterprise 管理者は、エンタープライズ設定 の 予算 で予算を管理します。Account 予算を含め、ツリー全体を管理できます。- 委任。 エンタープライズ管理者は、Manage access タブで予算をユーザーまたはグループと共有できます。委任された管理者は、その予算の配下に予算を作成し、それらの子予算に上限と一時的な上限を設定できます。委任機能は別途有効化が必要です。アカウント担当チームまでお問い合わせください。
- 委任された管理者は、共有された予算自体の上限を引き上げることはできません。 この上限を変更できるのは、親予算を管理する管理者のみです。
- メンバー は、自分の利用状況分析 で自分の使用量と上限を確認できます。

Engineering 予算の Manage access タブ(Bob をマネージャーとして設定した例)
よくある質問
組織管理者は組織の ACU 上限を設定できますか?
組織管理者は組織の ACU 上限を設定できますか?
組織上限エンドポイントが 409 を返すのはなぜですか?
組織上限エンドポイントが 409 を返すのはなぜですか?
409 を返します。エラーメッセージは「This organization has no limit of its own. Set the limit on its budget.」です。たとえば、Globex、Initech、Umbrella が 1 つの予算を共有している場合、Globex の上限を書き込もうとすると 409 が返されます。従来のユーザー上限エンドポイントはどうなりますか?
従来のユーザー上限エンドポイントはどうなりますか?
- ユーザーを指定し、予算を指定しないエンドポイント (
/v3beta1/enterprise/usage-policies/users/{user_id}、/v3beta1/enterprise/users/{user_id}/consumption/acu-limits) は、1 つの予算、つまりそのユーザーの請求先組織の予算に対してのみ、そのユーザーの上限を設定します。他の予算におけるそのユーザーの上限は変更されません。その組織に予算がない場合、呼び出しは409を返します。 - アカウント全体の階層、IdP グループ、およびデフォルトのユーザー使用量上限のエンドポイント (
/v3beta1/enterprise/usage-policies/tiers、/idp-groups、/v3beta1/enterprise/users/consumption/acu-limits) は、引き続きアカウント全体の階層を編集しますが、これらの階層はすでに強制適用されていません。
予算にクラウドとローカルで別々の上限を設定できますか?
予算にクラウドとローカルで別々の上限を設定できますか?
上限はいつリセットされますか?
上限はいつリセットされますか?
1 つの組織を 2 つの予算に含めることはできますか?
1 つの組織を 2 つの予算に含めることはできますか?
V3 API で予算を管理する
すべてのリクエストは、エンタープライズのサービスユーザートークンで認証します。呼び出し元には、アカウントの ManageAcuLimits 権限、またはその予算への委任されたアクセスが必要です。ベース URL にはhttps://api.devin.ai を使用します。認証およびサービスユーザーに関するガイダンスについては、V3 API の概要を参照してください。
予算スコープのコレクションエンドポイントでは、パスで予算を指定します:/v3beta1/enterprise/usage-policies/budgets/{budget_id}/...。単一のティアまたはリクエストを対象とするエンドポイント (/tiers/{tier_id}、/requests/{request_id}) は、そのティアまたはリクエストから予算を特定するため、アカウント全体のエンドポイントと同じパスを使用します。
PATCH のセマンティクス
PATCH エンドポイントでは、各フィールドは次のように処理されます。
- 省略したフィールドは変更されません。
nullを指定したフィールドはクリアされます。- 値を指定したフィールドは作成または更新されます。
予算関連のエンドポイント
予算の一覧を取得
budget_id: 予算スコープのパスで使用する識別子。parent_budget_id: 親予算。アカウントのルート予算の場合はnull。org_ids: この予算にリンクされている組織。これらの組織の使用量はこの予算に計上されます。リンクされている組織がない場合は空になります。status:activeまたはarchived。cycle_acu_limit: 月次請求期間ごとに、この予算とその子孫予算に対して課金される ACU消費量の上限。nullは無制限を表します。temporary_cycle_acu_limit: 現在の月次請求期間が終了するまでcycle_acu_limitを上書きする上限。有効な上限がない場合はnull。
予算を更新する
null を指定すると上限がクリアされます。少なくとも 1 つのフィールドを指定する必要があります。
parent_budget_id: 予算をそのサブ予算ごと、別のアクティブな予算の配下に移動します。ルート予算は移動できません。また、予算のネストは最大 3 階層までです。cycle_acu_limit、temporary_cycle_acu_limit: 予算の上限です (一覧取得のレスポンスと同じ形式) 。
temporary_cycle_acu_limit を再度設定すると、現在のウィンドウで改めて適用し直されます。1 つの組織のみにリンクされた予算の場合、cycle_acu_limit はその組織のACU上限としても適用されます。
ティアのエンドポイント
ティアの一覧
priority が最も高いものから順に並び、同じ priority 内では新しいティアが先になります。各ティアの形式は次のとおりです:
is_default: このティアが予算のデフォルトティアかどうか。cycle_acu_limit: 各メンバーに適用される、サイクルごとのデフォルトのACU上限。nullは上限がないことを示します。policy: このティアに対する上限引き上げリクエストの処理方法。unconditionalとconditionalはmax_limitまで承認し、manualは管理者によるレビューが必要です。max_limit: 引き上げリクエストを承認できる上限の最大値。nullの場合は上限なしで承認されます。cycle_acu_limitがnullの場合は常にnullになります。priority: ユーザーのIdPグループにマッピングされた階層の中で、このティアの優先順位を決める値。値が最も大きいティアが優先され、同値の場合は最も新しいティアが優先されます。ユーザーへの明示的な割り当てはこの順位付けより優先されます。また、デフォルトティアは順位付けの対象外です。member_count: 現在このティアに属しているユーザー数。デフォルトティアの場合は、他のティアに属していないすべての予算メンバーを数えます。
ティアを作成する
201 と、作成されたティアを返します。
ティアを取得する
ティアを更新する
ティアを削除する
204 を返します。デフォルトティアは削除できません (先に別のティアをデフォルトに昇格させてください) 。ユーザーが所属しているティアを削除する場合は、事前にそのユーザーを別のティアに移動し、そのティアへの IdPグループマッピングもすべて削除しておく必要があります。
ティアユーザーのエンドポイント
ティアのユーザー一覧を取得する
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(デフォルトティアへのフォールバック) のいずれかです。
ユーザーをティアに割り当てる
204 を返します。別のティアからユーザーを移動すると、ユーザーごとの上書き設定はすべてクリアされ、ユーザーには移動先ティアの上限がそのまま継承されます。
ティアからユーザーを削除する
204 を返します。
ユーザーエンドポイント
ユーザーの上限を取得する
tier_id/tier_name: ユーザーの上限の決定元となるティア (明示的な割り当て、IdPグループマッピング、またはデフォルトティア) 。予算にティアがない場合はnullになります。tier_cycle_acu_limit: 上書き設定を適用する前の、ティア自体の上限。nullの場合は上限がないことを意味します。pending_request_id/pending_request_cycle_acu_limit: ユーザーの保留中の上限引き上げリクエストと、そのリクエストで要求している上限 (存在する場合) 。
ユーザーの上書き設定を指定またはクリアする
kind が必須です。permanent は無期限で、temporary は現在の月次請求期間の終了時に失効します。
リクエストボディ — すべての上書き設定をクリアする
204 を返します。
IdP グループのエンドポイント
IdP グループをティアに関連付けると、そのグループのメンバーにティアが自動的に継承されます。マッピングはグループメンバーシップに基づいてリアルタイムで決定され、ユーザーに明示的に割り当てられたティアが変更されることはありません。明示的な割り当てが常に優先されます。複数のマッピング済みグループに属するユーザーには、最上位のマッピング済みティア (ティアのpriority が最も高いもの。同順位の場合は最も新しいティア) が適用されます。
IdPグループマッピングの一覧を取得
?tier_id= でフィルターすると、特定の 1 つのティアに関連付けられたグループのみを一覧表示できます:
IdP グループのマッピングを取得する
404 を返します。
IdPグループをティアにマッピングする
IdP グループの関連付けを解除する
204 を返します。マッピング済みティアは、そのグループのメンバーに適用されなくなります。明示的な割り当てがなく、他のマッピング済みティアも適用されないユーザーには、デフォルトティアが適用されます。
上限引き上げリクエストのエンドポイント
ユーザーは、サイクルごとの上限の引き上げをリクエストできます。リクエストの処理方法は、リクエスト者のティアのpolicy によって決まります。unconditional と conditional の場合はティアの max_limit まで自動的に承認され、manual の場合はリクエストが保留され、管理者がこれらのエンドポイントを使ってレビューします。
上限引き上げリクエストの一覧
?status= (pending、approved、denied、expired) および ?user_id= でフィルターできます。
tier_id/tier_name: 予算内でのリクエスト者のティア。予算にティアがない場合はnullになります。current_cycle_acu_limit: リクエスト者に現在適用されている上限。nullの場合は上限がないことを示します。status:expiredは、請求サイクルの終了時点でリクエストがまだ保留中だったことを示します。reviewer: リクエストをレビューした管理者。保留中はnullになります。
上限引き上げリクエストを取得する
上限引き上げリクエストを承認する
409 を返します。
上限引き上げリクエストを拒否する
409 を返します。
ワークフローの例
予算のティアを設定する
対象の予算を特定して月 2,000 ACU の上限を設定し、デフォルトティアを作成して、予算のすべてのメンバーに月 500 ACU の上限を適用します。アカウント全体のユーザーごとの上限からの移行
ユーザーごとの上限の設定先は、アカウント階層から予算へ移行します。予算をマージ (オプション 2) しない限り、組織の上限は変わりません。予算でユーザーごとの上限を設定すると、チームごとに個別の上限を設けられるほか、グループとユーザーの上限を一か所で管理できます。 お客様の企業で切り替えが完了するまでは、アカウント全体の階層と上書き設定が引き続き適用されます。 移行するには、予算を編集できる管理者権限が必要です。エンタープライズ設定 > 使用量ポリシー を開くと、上部に「User limits are migrating to per-budget user limits.」というバナーが表示されます。バナーをクリックすると、予算の一覧が表示されます。
展開して予算を表示した移行バナー
オプション 1: ユーザーごとの上限を各予算にコピーする
テーブルヘッダーのチェックボックスですべての予算を選択し、Copy user limits をクリックします。すべての予算に現在の階層が適用されます。What to copy では、IdPグループマッピング、割り当て、上書き設定がデフォルトで選択されています。これらもコピーする場合は、選択したままにしてください。
選択したすべての予算にユーザーごとの上限をコピー

コピーされたティアが各予算に設定された状態
オプション 2: ユーザー上限を 1 人につき 1 つにし、組織の上限は適用しない
- Account 予算を選択し、Copy user limits をクリックします。Account 予算がリストにない場合は、先にステップ 2 と 3 を実行してください。組織が含まれると、リストに表示されるようになります。
-
その他の予算をそれぞれ選択し、Merge into をクリックして、Account 予算の名前を選択します。

Account 予算にマージするため、その他の予算を選択した状態
-
マージを確定します。

マージの確定

マージ後、すべての組織が Account 予算に含まれた状態
オプション 3: その他の構成
組織を予算の下にまとめ、予算ごとに異なるユーザーごとの上限を設定します。設定例については、委任管理者を置く部門またはユーザーごとの上限を高く設定したプロジェクト用予算を参照してください。アカウント担当チームと一緒に設定を進めることもできます。適用を有効にする
Enforce per-budget user limits をオンにします。確定する前に、現在の請求サイクルでの使用量に基づき、ブロックされることになる人数が Devin に表示されます。
ブロックされる人数を確認して適用を確定する

予算単位のユーザーごとの上限が適用された状態
API で上限を設定している場合
予算 API を利用してください。この API では、/v3beta1/enterprise/usage-policies/budgets 配下で各予算の上限、階層、上書き設定を設定します。組織の上限 API (/v3/enterprise/consumption/acu-limits/devin 配下) は引き続きサポートされます。従来のユーザー上限エンドポイントは、切り替え後に意味が変わります。詳しくは 従来のユーザー上限エンドポイントはどうなりますか? を参照してください。
