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.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.

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

Ein Abteilungsadministrator erhöht das Limit eines untergeordneten Budgets

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.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“ 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.Budget-Baum mit Budgets und Ebenen für Nutzerlimits

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. Einnull-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.
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 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.
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.
unconditionalundconditionalgenehmigen Anfragen bis zummax_limitder Ebene.manualleitet 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.

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 mit Bob als Manager
Häufig gestellte Fragen
Können Organisationsadministratoren das ACU-Limit einer Organisation festlegen?
Können Organisationsadministratoren das ACU-Limit einer Organisation festlegen?
Warum gibt der Org-Limit-Endpunkt 409 zurück?
Warum gibt der Org-Limit-Endpunkt 409 zurück?
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.Wann werden Limits zurückgesetzt?
Wann werden Limits zurückgesetzt?
Kann eine Organisation zu zwei Budgets gehören?
Kann eine Organisation zu zwei Budgets gehören?
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 Siehttps://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 diePATCH-Endpunkte gilt:
- Ein weggelassenes Feld bleibt unverändert.
- Ein auf
nullgesetztes Feld wird gelöscht. - Ein auf einen Wert gesetztes Feld wird erstellt oder aktualisiert.
Budget-Endpunkte
Budgets auflisten
budget_id: der Bezeichner, der in budgetbezogenen Pfaden verwendet wird.parent_budget_id: das übergeordnete Budget;nullbeim 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:activeoderarchived.cycle_acu_limit: das Limit des Budgets für den ACU-Verbrauch, der ihm und seinen untergeordneten Budgets pro monatlichem Abrechnungszeitraum angerechnet wird;nullbedeutet unbegrenzt.temporary_cycle_acu_limit: ein Limit, dascycle_acu_limitbis zum Ende des aktuellen monatlichen Abrechnungszeitraums überschreibt;null, wenn derzeit keines gilt.
Ein Budget aktualisieren
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.
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
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;nullbedeutet unbegrenzt.policy: legt fest, wie Anfragen zur Erhöhung des Limits für die Ebene behandelt werden –unconditionalundconditionalgenehmigen bis zumax_limit,manualerfordert ein Review durch einen Administrator.max_limit: das maximale Limit, bis zu dem Anfragen zur Erhöhung des Limits genehmigt werden; beinullwird ohne Obergrenze genehmigt. Immernull, wenncycle_acu_limitnullist.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
201 mit der erstellten Ebene zurück.
Ebene abrufen
Eine Ebene aktualisieren
Ebene löschen
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
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;nullbedeutet unbegrenzt.limit_source: Herkunft des effektiven Limits –override(dauerhaft),temporary_overrideodertier.membership: Grund für die Zugehörigkeit des Nutzers zur Ebene –explicit(direkt zugewiesen),idp_group(über seine maßgebliche IdP-Gruppenzuordnung) oderdefault(Rückgriff auf die Standardstufe).
Einen Nutzer einer Ebene zuweisen
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
204 zurück.
Nutzer-Endpunkte
Limits eines Nutzers abrufen
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;nullbedeutet 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
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
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öchstepriority der Ebene; bei Gleichstand entscheidet die neueste Ebene).
IdP-Gruppenzuordnungen auflisten
?tier_id=, um nur die Gruppen aufzulisten, die einer bestimmten Ebene zugeordnet sind:
Zuordnung einer IdP-Gruppe abrufen
404 zurück, wenn für die Gruppe im Budget keine Zuordnung vorhanden ist.
Eine IdP-Gruppe einer Nutzungsstufe zuordnen
Zuordnung einer IdP-Gruppe aufheben
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 derpolicy 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
?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;nullbedeutet unbegrenzt.status:expiredbedeutet, 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
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
409, falls die Anfrage bereits geprüft wurde.

