Zum Hauptinhalt springen
Mit Budgets begrenzen Sie die ACU-Nutzung entsprechend der Organisationsstruktur Ihres Unternehmens: ein Limit für das gesamte Konto, gemeinsame Pools für Teams oder Projekte und Limits pro Benutzer innerhalb der einzelnen Pools.

Beispielhafte Anwendungsfälle

Abteilungen mit beauftragten Administratoren

Acme Corp hat 10 Abteilungen. Jede Abteilungsleitung verwaltet die Limits ihrer Organisationen. Die zentrale IT legt das Gesamtlimit jeder Abteilung fest. Dieses Beispiel zeigt zwei davon. Alice, die Enterprise-Administratorin, erstellt unter dem Account-Budget für jede Abteilung ein eigenes Budget. Jedes davon teilt sie mit dem zuständigen Abteilungsadministrator. Jeder Abteilungsadministrator erstellt wiederum für jede seiner Organisationen ein Budget.
Account-Budget von 100,000 ACU mit Engineering bei 30,000 ACU, darunter Payments und Search, sowie Marketing bei 5,000 ACU.

Abteilungsbudgets unter dem Account-Budget

  • Bob, der Administrator der Abteilung Engineering, kann für jedes Budget unter Engineering Limits und temporäre Limits festlegen. Zum Beispiel kann er Payments für eine arbeitsintensive Woche ein temporäres Limit von 6,000 ACU zuweisen.
  • Bob kann das Limit von 30,000 ACU für Engineering nicht erhöhen. Das kann nur Alice.
  • Die Nutzung in allen Engineering-Organisationen wird auf das Limit von 30,000 ACU angerechnet, auch wenn die Organisationsbudgets zusammen mehr ergeben.
Seite „Budgets“ aus Sicht eines Abteilungsadministrators

Die Seite „Budgets“ aus Sicht eines Abteilungsadministrators, mit gesperrtem Account-Budget

Limit eines untergeordneten Budgets erhöhen

Ein Abteilungsadministrator erhöht das Limit eines untergeordneten Budgets

Limit des Abteilungsbudgets ist schreibgeschützt

Ein Abteilungsadministrator kann das Limit des Abteilungsbudgets nicht ändern

Ein Projektbudget mit höheren Nutzer-Limits

Jeder Entwickler erhält 200 ACUs pro Monat. Für die Migrationsinitiative stellt Acme Corp zusätzlich 5,000 ACUs bereit und gewährt den Projektbeteiligten ein höheres Kontingent. Belassen Sie die Developer-tools-Organisationen in einem Budget „Developer tools“ mit einer Standardstufe von 200 ACU. Erstellen Sie ein Budget „Migration initiative“ mit einem Limit von 5,000 ACU. Ordnen Sie diesem Budget die Organisation des Projekts zu und legen Sie eine Standardstufe von 1,000 ACU fest. Beide Budgets sind dem Account-Budget untergeordnet.
Developer tools mit 20,000 ACU und einer Standardstufe von 200 ACU sowie Migration initiative mit 5,000 ACU und einer Standardstufe von 1,000 ACU.

Die Budgets „Developer tools“ und „Migration initiative“ mit ihren Ebenen

  • Carol, Entwicklerin im Projekt, kann in der Migration-Organisation bis zu 1,000 ACUs nutzen, in den Developer-tools-Organisationen bis zu 200 ACUs.
  • Das gesamte Projekt kann pro Monat nie mehr als 5,000 ACUs verbrauchen.
Budgetauswahl unter „Meine Analysen“

Budgetauswahl unter „Meine Analysen“ mit mehreren Budgets

So funktionieren Budgets

Budget-Baum

Jedes Enterprise-Konto hat genau einen Budget-Baum. Der Root bildet das Account budget, darunter liegen untergeordnete Budgets. Ein Baum kann bis zu drei Ebenen tief sein. Ein Budget kann eine oder mehrere Organisationen enthalten. Jede Organisation gehört zu genau einem Budget. Neue Organisationen werden dem Account budget zugeordnet. Zum Beispiel legt Acme Corp für sein Account budget ein Limit von 100,000 ACU fest. Engineering teilt seinen Pool auf drei untergeordnete Budgets auf.
Account budget mit 100,000 ACU, darunter Engineering mit 40,000 ACU und seinen drei untergeordneten Budgets sowie Developer tools mit 20,000 ACU und drei Ebenen für Nutzerlimits.

Budget-Baum mit Budgets und Ebenen für Nutzerlimits

Ebenen sind Limits pro Nutzer innerhalb eines Budgets, keine eigenständigen Budgets.
Budget-Baum mit Auslastung pro Budget

Budget-Baum mit Auslastung pro Budget (Beispieldaten)

Budget-Limits

Ein Budget-Limit begrenzt die gemeinsame ACU-Nutzung der Organisationen des Budgets und der Organisationen in seinen untergeordneten Budgets innerhalb eines monatlichen Zeitfensters. Ein null-Limit bedeutet unbegrenzt.
  • Die Nutzung wird auf jedes übergeordnete Budget angerechnet. Die Nutzung in einem untergeordneten Budget wird auch auf dessen übergeordnetes Budget und auf das Account-Budget angerechnet.
  • Ein ausgeschöpftes übergeordnetes Budget blockiert seine untergeordneten Budgets. Sobald ein Budget auf dem Pfad aufgebraucht ist, wird die Nutzung in diesem Zweig gestoppt.
  • Die Limits untergeordneter Budgets können in Summe das Limit des übergeordneten Budgets übersteigen. Das Limit des übergeordneten Budgets begrenzt trotzdem ihre gemeinsame Nutzung.
  • Auch ein Budget ohne Limit wird durch seine übergeordneten Budgets begrenzt.
Ein Budget, das mit genau einer Organisation verknüpft ist, teilt sein Limit mit dieser Organisation. Auch die veralteten Endpunkte für ACU-Limits auf Organisationsebene legen dieses Limit fest. Alternativ können Sie den unten beschriebenen Update-Endpunkt verwenden.

Was passiert, wenn ein Budget aufgebraucht ist

Ist ein Budget aufgebraucht, wird die Nutzung für die zugehörigen Organisationen gestoppt. Das gilt auch, wenn ein übergeordnetes Budget aufgebraucht ist. Die Nutzung ist im nächsten Zeitfenster wieder möglich oder sobald ein Administrator das Limit erhöht oder ein temporäres Limit festlegt.
  • Devin-Sitzungen: Neue Sitzungen können nicht gestartet werden, und laufende Sitzungen wechseln in den Ruhezustand. Nutzer sehen die Meldung „Increase your organization’s usage limit.“
  • Devin CLI und lokaler Agent in Desktop: Anfragen werden blockiert. Nutzer sehen die Meldung „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: Neue Reviews werden blockiert.
Composer-Banner: Nutzungslimit erreicht

Composer-Banner bei aufgebrauchtem Budget

Monatliches Zeitfenster

Budget-Limits, Nutzer-Limits und temporäre Limits werden zu Beginn jedes monatlichen Zeitfensters zurückgesetzt. Jedes Zeitfenster beginnt am Starttag Ihrer Abrechnungsphase und entspricht daher nicht unbedingt dem Kalendermonat. Beginnt die Abrechnungsphase zum Beispiel am 15., laufen die Zeitfenster vom 15. Oktober bis 14. November, dann vom 15. November bis 14. Dezember. Ein temporäres Limit ersetzt das Budget-Limit für den Rest des aktuellen Zeitfensters. Im nächsten Zeitfenster gilt wieder das dauerhafte Limit. Eine temporäre Nutzerüberschreibung läuft am Ende des aktuellen Zeitfensters ab.
Marketing-Budget mit einem temporären Limit

Ein temporäres Limit erhöht das Marketing-Budget nur für dieses Zeitfenster auf 6,000 ACUs

Nutzerlimits in einem Budget

Nutzerlimits begrenzen, wie viel eine einzelne Person innerhalb eines monatlichen Zeitfensters verbrauchen kann. Jedes Budget mit einer verknüpften Organisation hat eigene Nutzerlimits, die ausschließlich innerhalb dieses Budgets gelten.
  • Ebenen. Jedes Budget hat eigene Ebenen und genau eine Standardstufe. Eine Ebene legt das monatliche ACU-Limit für ihre Mitglieder fest.
  • IdP-Gruppenzuordnungen. Ordnen Sie eine Gruppe aus Ihrem Identity Provider einer Ebene zu. Mitglieder der Gruppe werden dann dieser Ebene zugewiesen.
  • Überschreibungen. Legen Sie für einen einzelnen Nutzer ein dauerhaftes oder befristetes Limit fest.
  • Anfragerichtlinien. Jede Ebene legt fest, wie Anfragen zur Limiterhöhung behandelt werden. unconditional und conditional genehmigen Anfragen bis zum max_limit der Ebene. manual leitet Anfragen zur Prüfung an einen Administrator weiter.
  • Geltungsbereich. Für ein Nutzerlimit zählt nur die Nutzung des Nutzers in den Organisationen dieses Budgets.
  • Kopieren und löschen. Kopieren Sie Ebenen aus einem anderen Budget oder aus dem Konto. Sie können auch IdP-Gruppenzuordnungen, Zuweisungen und Überschreibungen kopieren. Um neu zu beginnen, löschen Sie alle Ebenen in einem Budget.
Ein Nutzerlimit für ein übergeordnetes Budget gilt nicht für dessen untergeordnete Budgets. Wenn Engineering zum Beispiel selbst ebenfalls eine Organisation enthält, begrenzt ein Nutzerlimit von 300 ACU für Engineering nicht die Nutzung eines Nutzers in Payments oder Search.
Dialog „Nutzungsrichtlinien kopieren“

Dialog „Nutzungsrichtlinien kopieren“ mit Developer tools als Quelle

Wer ein Budget verwalten kann

Enterprise-Admins verwalten Budgets in Enterprise Settings unter Budgets. Sie verwalten den gesamten Baum, einschließlich des Account-Budgets.
  • Delegation. Ein Enterprise-Administrator kann ein Budget auf der Registerkarte „Manage access“ für eine Person oder Gruppe freigeben. Ein beauftragter Administrator kann darunter Budgets erstellen sowie Limits und temporäre Limits für diese untergeordneten Budgets festlegen. Die Delegation muss separat aktiviert werden; wenden Sie sich dazu an Ihr Kundenbetreuungsteam.
  • Ein beauftragter Administrator kann das Limit des freigegebenen Budgets selbst nicht erhöhen. Das kann nur ein Administrator, der das übergeordnete Budget verwaltet.
  • Mitglieder sehen ihre eigene Nutzung und ihr Limit unter „Meine Analysen“.
Registerkarte „Manage access“ des Engineering-Budgets

Registerkarte „Manage access“ des Engineering-Budgets mit Bob als Manager

Häufig gestellte Fragen

Nein. ACU-Limits für Organisationen legen Enterprise-Admins fest. Wenn ein Team seine Limits selbst verwalten soll, geben Sie ein Budget für den Administrator des Teams frei.
Sobald Budget-Limits für Ihr Unternehmen erzwungen werden, gibt der Org-Limit-Endpunkt HTTP 409 zurück, wenn die Organisation ihr Budget mit anderen Organisationen teilt oder direkt dem Account-Budget zugeordnet ist. Die Fehlermeldung lautet: „This organization has no limit of its own. Set the limit on its budget.“ Wenn sich zum Beispiel Globex, Initech und Umbrella ein Budget teilen, gibt ein Schreibzugriff auf das Limit von Globex 409 zurück.
Zu Beginn jedes monatlichen Zeitfensters. Das Zeitfenster beginnt am Starttag Ihrer Abrechnungsphase.
Nein. Jede Organisation gehört zu genau einem Budget. Ein Budget kann jedoch mehrere Organisationen umfassen.

Budgets mit der V3-API verwalten

Alle Anfragen werden mit einem Enterprise-Service-User-Token authentifiziert. Aufrufende benötigen die Kontoberechtigung ManageAcuLimits oder delegierten Zugriff auf das Budget. Verwenden Sie https://api.devin.ai als Base URL. In der V3-API-Übersicht finden Sie Hinweise zur Authentifizierung und zu Service-Benutzern. Budgetbezogene Collection-Endpunkte erwarten das Budget im Pfad: /v3beta1/enterprise/usage-policies/budgets/{budget_id}/.... Endpunkte, die eine einzelne Ebene oder Anfrage adressieren (/tiers/{tier_id}, /requests/{request_id}), beziehen das Budget aus der Ebene bzw. Anfrage und nutzen daher dieselben Pfade wie die kontoweiten Endpunkte.

PATCH-Semantik

Für die PATCH-Endpunkte gilt:
  • Ein weggelassenes Feld bleibt unverändert.
  • Ein auf null gesetztes Feld wird gelöscht.
  • Ein auf einen Wert gesetztes Feld wird erstellt oder aktualisiert.

Budget-Endpunkte

Budgets auflisten

Gibt eine paginierte Liste aller aktiven und archivierten Budgets des Kontos zurück. Jedes Budget hat folgende Struktur:
  • budget_id: der Bezeichner, der in budgetbezogenen Pfaden verwendet wird.
  • parent_budget_id: das übergeordnete Budget; null beim Root-Budget des Kontos.
  • org_ids: die mit diesem Budget verknüpften Organisationen. Ihre Nutzung wird auf dieses Budget angerechnet. Leer, wenn keine Organisation verknüpft ist.
  • status: active oder archived.
  • cycle_acu_limit: das Limit des Budgets für den ACU-Verbrauch, der ihm und seinen untergeordneten Budgets pro monatlichem Abrechnungszeitraum angerechnet wird; null bedeutet unbegrenzt.
  • temporary_cycle_acu_limit: ein Limit, das cycle_acu_limit bis zum Ende des aktuellen monatlichen Abrechnungszeitraums überschreibt; null, wenn derzeit keines gilt.

Ein Budget aktualisieren

Partielles Update: Weggelassene Felder bleiben unverändert, und null löscht ein Limit. Mindestens ein Feld ist erforderlich.
  • parent_budget_id: Verschiebt das Budget samt seinen Unterbudgets unter ein anderes aktives Budget. Das Root-Budget kann nicht verschoben werden, und Budgets lassen sich höchstens drei Ebenen tief verschachteln.
  • cycle_acu_limit, temporary_cycle_acu_limit: Die Limits des Budgets, wie in der Antwort des List-Endpunkts.
Request-Body — Limit und eine temporäre Erhöhung für diesen Monat festlegen
Request-Body – Limits entfernen
Request-Body – Budget einem anderen Budget unterordnen
Gibt das aktualisierte Budget zurück. Wird temporary_cycle_acu_limit erneut gesetzt, startet es für das aktuelle Zeitfenster neu. Bei einem Budget, das mit genau einer Organisation verknüpft ist, wird cycle_acu_limit außerdem zum ACU-Limit der Organisation.

Ebenen-Endpunkte

Ebenen auflisten

Gibt eine paginierte Liste der Ebenen des Budgets, sortiert nach Vorrang, zurück: Ebenen mit der höchsten priority zuerst, innerhalb derselben Priorität die neueste Ebene zuerst. Eine Ebene sieht wie folgt aus:
  • is_default: gibt an, ob dies die Standardebene des Budgets ist.
  • cycle_acu_limit: das standardmäßige ACU-Limit pro Zyklus für jedes Mitglied; null bedeutet unbegrenzt.
  • policy: legt fest, wie Anfragen zur Erhöhung des Limits für die Ebene behandelt werden – unconditional und conditional genehmigen bis zu max_limit, manual erfordert ein Review durch einen Administrator.
  • max_limit: das maximale Limit, bis zu dem Anfragen zur Erhöhung des Limits genehmigt werden; bei null wird ohne Obergrenze genehmigt. Immer null, wenn cycle_acu_limit null ist.
  • priority: bestimmt den Rang der Ebene unter den IdP-Gruppen zugeordneten Ebenen eines Nutzers – der höchste Wert hat Vorrang, bei Gleichstand entscheidet die neueste Ebene. Eine explizite Zuweisung eines Nutzers hat Vorrang vor dieser Rangfolge; die Standardebene wird nie in die Rangfolge einbezogen.
  • member_count: die Anzahl der Nutzer, die sich aktuell in der Ebene befinden. Bei der Standardebene werden alle Budget-Mitglieder gezählt, die keiner anderen Ebene angehören.

Ebene erstellen

Request-Body
Die erste Ebene eines Budgets wird automatisch zu dessen Standardstufe. Gibt HTTP 201 mit der erstellten Ebene zurück.

Ebene abrufen

Eine Ebene aktualisieren

Teilweises Update; nicht angegebene Felder bleiben unverändert.

Ebene löschen

Gibt bei Erfolg HTTP 204 zurück. Die Standardstufe kann nicht gelöscht werden (machen Sie zuerst eine andere Ebene zur Standardstufe). Bevor eine Ebene gelöscht werden kann, müssen alle ihre Nutzer verschoben und sämtliche IdP-Gruppenzuordnungen zu dieser Ebene entfernt werden.

Endpunkte für Ebenen-Nutzer

Nutzer einer Ebene auflisten

Gibt eine paginierte Liste der Nutzer dieser Ebene samt ihren ermittelten Limits zurück. Bei der Standardstufe umfasst sie alle Mitglieder des Budgets, die keiner anderen Ebene zugeordnet sind:
  • cycle_acu_limit_override: die dauerhafte Überschreibung des Nutzers, sofern vorhanden.
  • temporary_cycle_acu_limit: die temporäre Überschreibung des Nutzers; nur vorhanden, solange sie im aktuellen monatlichen Abrechnungszeitraum gilt.
  • effective_cycle_acu_limit: das Limit, das derzeit für den Nutzer durchgesetzt wird; null bedeutet unbegrenzt.
  • limit_source: Herkunft des effektiven Limits – override (dauerhaft), temporary_override oder tier.
  • membership: Grund für die Zugehörigkeit des Nutzers zur Ebene – explicit (direkt zugewiesen), idp_group (über seine maßgebliche IdP-Gruppenzuordnung) oder default (Rückgriff auf die Standardstufe).

Einen Nutzer einer Ebene zuweisen

Idempotent. Gibt bei Erfolg HTTP 204 zurück. Wird ein Nutzer aus einer anderen Ebene verschoben, wird jede benutzerspezifische Überschreibung gelöscht, sodass er zunächst das Limit der Zielebene erbt.

Nutzer aus einer Ebene entfernen

Entfernt die explizite Ebenenzuweisung des Nutzers (einschließlich etwaiger Überschreibungen). Der Nutzer bezieht anschließend die seiner IdP-Gruppe zugeordnete Ebene, sofern vorhanden, andernfalls die Standardebene. Gibt bei Erfolg HTTP 204 zurück.

Nutzer-Endpunkte

Limits eines Nutzers abrufen

Gibt die ermittelte Ebene, die Limits und die ausstehende Anfrage des Nutzers innerhalb des Budgets zurück. Enthält die oben beschriebenen Nutzerfelder der Ebene sowie:
  • tier_id / tier_name: die Ebene, aus der sich das Limit des Nutzers ergibt (explizite Zuweisung, IdP-Gruppenzuordnung oder die Standardstufe); null, wenn das Budget keine Ebenen hat.
  • tier_cycle_acu_limit: das eigene Limit der Ebene vor einer etwaigen Überschreibung; null bedeutet unbegrenzt.
  • pending_request_id / pending_request_cycle_acu_limit: die ausstehende Anfrage des Nutzers zur Erhöhung des Limits und das darin angefragte Limit, sofern vorhanden.

Überschreibung für einen Nutzer festlegen oder löschen

Nutzerbezogen: Das Ziel muss lediglich Mitglied des Budgets sein – es ist keine Ebene beteiligt, und die Ebenenzuweisung des Nutzers wird nie geändert. Request-Body – temporäre Überschreibung festlegen
kind ist beim Festlegen eines Werts erforderlich: permanent läuft nie ab, temporary läuft am Ende des aktuellen monatlichen Abrechnungszeitraums ab. Request-Body – alle Überschreibungen löschen
Der Endpunkt gibt bei Erfolg HTTP 204 zurück.

IdP-Gruppen-Endpunkte

Ordnen Sie eine IdP-Gruppe einer Ebene zu, damit deren Member diese Ebene automatisch erben. Zuordnungen werden live anhand der Gruppenmitgliedschaft ermittelt und ändern nie die explizite Ebenen-Zuweisung eines Nutzers – eine explizite Zuweisung hat immer Vorrang. Ist ein Nutzer Mitglied mehrerer zugeordneter Gruppen, gilt für ihn die am höchsten eingestufte zugeordnete Ebene (höchste priority der Ebene; bei Gleichstand entscheidet die neueste Ebene).

IdP-Gruppenzuordnungen auflisten

Gibt eine paginierte Liste der Zuordnungen von Gruppen zu Ebenen für das Budget zurück, sortiert vom ältesten zum neuesten Eintrag. Filtern Sie mit ?tier_id=, um nur die Gruppen aufzulisten, die einer bestimmten Ebene zugeordnet sind:

Zuordnung einer IdP-Gruppe abrufen

Gibt HTTP 404 zurück, wenn für die Gruppe im Budget keine Zuordnung vorhanden ist.

Eine IdP-Gruppe einer Nutzungsstufe zuordnen

Request-Body
Idempotenter Upsert. Die Ebene muss zum Budget gehören. Eine Gruppe kann pro Budget höchstens einer Ebene zugeordnet sein. Wird eine bereits zugeordnete Gruppe erneut zugeordnet, wird sie daher in die angegebene Ebene verschoben.

Zuordnung einer IdP-Gruppe aufheben

Gibt bei Erfolg HTTP 204 zurück. Die zugeordnete Ebene gilt dann nicht mehr für die Mitglieder der Gruppe; Nutzer ohne explizite Zuweisung und ohne andere zugeordnete Ebene fallen auf die Standardebene zurück.

Endpunkte für Anfragen zur Erhöhung des Limits

Nutzer können ein höheres Limit pro Abrechnungszyklus anfragen. Was dann passiert, hängt von der policy der Ebene ab, der der anfragende Nutzer zugeordnet ist: Bei unconditional und conditional werden Anfragen bis zum max_limit der Ebene automatisch genehmigt, bei manual wird die Anfrage zurückgehalten, bis ein Administrator sie über diese Endpunkte prüft (Review).

Anfragen zur Erhöhung des Limits auflisten

Gibt eine paginierte Liste der Anträge für dieses Budget zurück, die sich mit ?status= (pending, approved, denied, expired) und ?user_id= filtern lässt:
  • tier_id / tier_name: die Ebene des Antragstellers innerhalb des Budgets; null, wenn das Budget keine Ebenen hat.
  • current_cycle_acu_limit: das derzeit für den Antragsteller geltende Limit; null bedeutet unbegrenzt.
  • status: expired bedeutet, dass die Anfrage zum Ende ihres Abrechnungszyklus noch offen war.
  • reviewer: der Administrator, der die Anfrage geprüft hat; null, solange sie noch offen ist.

Anfrage zur Erhöhung des Limits abrufen

Anfrage zur Erhöhung des Limits genehmigen

Gewährt das angeforderte Limit als temporäre Überschreibung, die am Ende des aktuellen monatlichen Abrechnungszeitraums abläuft. Optional können Sie stattdessen ein anderes Limit gewähren:
Gibt die aktualisierte Anfrage zurück. Gibt HTTP 409 zurück, wenn die Anfrage bereits geprüft wurde oder der Anfragende kein Konto-Member mehr ist.

Anfrage zur Erhöhung des Limits ablehnen

Gibt die aktualisierte Anfrage zurück oder HTTP 409, falls die Anfrage bereits geprüft wurde.

Beispiel-Arbeitsabläufe

Ebenen eines Budgets einrichten

Suchen Sie das Budget, begrenzen Sie es auf 2.000 ACUs pro Monat und erstellen Sie dann eine Standardstufe, damit jedes Mitglied des Budgets eine monatliche Obergrenze von 500 ACU erhält:
Ordnen Sie der Ebene eine IdP-Gruppe zu und gewähren Sie einem Nutzer für den Rest des Monats eine vorübergehende Erhöhung: