ユースケースの例
部門管理者への委任
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: 新しいレビューはブロックされます。

予算を使い切ったときに表示されるコンポーザーのバナー
月次期間
予算の上限、ユーザーの上限、一時的な上限は、各月次期間の開始時にリセットされます。各期間は請求フェーズの開始日から始まるため、必ずしも暦月とは一致しません。 たとえば、請求フェーズが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 上限を設定できますか?
いいえ。組織の ACU 上限を設定するのは Enterprise 管理者です。チームが自身の上限を管理できるようにするには、そのチームの管理者と予算を共有してください。
組織上限エンドポイントが 409 を返すのはなぜですか?
組織上限エンドポイントが 409 を返すのはなぜですか?
お客様の企業で予算の上限が強制適用されている場合、組織が他の組織と予算を共有しているとき、または組織が Account 予算の直下にあるときは、組織上限エンドポイントは HTTP
409 を返します。エラーメッセージは「This organization has no limit of its own. Set the limit on its budget.」です。たとえば、Globex、Initech、Umbrella が 1 つの予算を共有している場合、Globex の上限を書き込もうとすると 409 が返されます。上限はいつリセットされますか?
上限はいつリセットされますか?
各月次期間の開始時にリセットされます。月次期間は、請求フェーズの開始日から始まります。
1 つの組織を 2 つの予算に含めることはできますか?
1 つの組織を 2 つの予算に含めることはできますか?
いいえ。各組織が属する予算は必ず 1 つだけです。一方、1 つの予算には複数の組織を含めることができます。
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 を返します。

