Skip to main content
Limits auf Nutzerebene befinden sich in der Beta-Phase und erfordern, dass die Funktion für Ihr Enterprise aktiviert ist. Wenden Sie sich an Ihr Account-Team, um diese Funktion zu aktivieren.
Ein Limit auf Nutzerebene begrenzt die kombinierte **lokale und Cloud-**ACU-Nutzung eines Nutzers — Cloud-Devin-Sitzungen sowie Devin Desktop, Windsurf JetBrains und Devin CLI werden auf dieselbe Obergrenze angerechnet. Wenn ein Nutzer sein Limit erreicht, kann er auf diesen Oberflächen keine neue Arbeit starten, bis das Limit erhöht wird oder die Nutzung im nächsten monatlichen Zeitfenster zurückgesetzt wird. Sie können Ebenen und Limits auf Nutzerebene in der Web-App unter Enterprise Settings in den Nutzungsrichtlinien (siehe den Leitfaden zu Nutzungsrichtlinien) oder über die unten aufgeführten Endpunkte für Nutzungsrichtlinien verwalten. Limits auf Nutzerebene werden über Ebenen verwaltet. Eine Ebene ist eine benannte, kontoweite Standardobergrenze, die für alle ihre Member gilt:
  • Nutzer werden auf drei Arten einer Ebene zugeordnet: Ein Admin weist sie explizit zu, eine IdP-Gruppenzuordnung ordnet sie zu (eine Gruppe wird einer Ebene zugeordnet und ihre Member erben diese Ebene, sofern sie nicht explizit einer anderen Ebene zugewiesen sind), oder sie werden der Standardebene zugeordnet. Jedes Konto kann eine Ebene als Standardebene festlegen; jeder Konto-Member, dem keine andere Ebene zugewiesen ist, gehört zu ihr. Es gibt kein separates „Standardlimit pro Nutzer“ — konfigurieren Sie stattdessen die Standardebene.
  • Einzelne Nutzer können eine Überschreibung haben — entweder dauerhaft (läuft nie ab) oder temporär (läuft am Ende des aktuellen monatlichen Zeitfensters ab). Überschreibungen gelten für einzelne Nutzer: Das Festlegen einer Überschreibung ändert niemals die Ebenenzuweisung des Nutzers.
  • Das effektive Limit eines Nutzers wird in dieser Reihenfolge bestimmt: dauerhafte Überschreibung, andernfalls eine aktive temporäre Überschreibung, andernfalls cycle_acu_limit der explizit zugewiesenen Ebene, andernfalls das Limit der am höchsten eingestuften über eine IdP-Gruppe zugeordneten Ebene, andernfalls das Limit der Standardebene. Ein null-Limit bedeutet, dass keine Obergrenze besteht.
  • Nutzer können ein höheres Limit anfordern; Admins prüfen diese Anfragen zur Erhöhung des Limits. Die policy jeder Ebene steuert, ob Anfragen automatisch genehmigt oder zur manuellen Prüfung zurückgehalten werden.
Limits auf Nutzerebene sind unabhängig von Limits auf Organisationsebene — eine Anfrage wird blockiert, wenn eines der beiden Limits erreicht wurde. Informationen zu Authentifizierung, Berechtigungen und der von allen Endpunkten auf dieser Seite verwendeten PATCH-Semantik finden Sie unter ACU-Limits.
Die Endpunkte für Limits pro Nutzer und Standardnutzer aus der Zeit vor den Ebenen sind veraltet; siehe Legacy user ACU limit endpoints.

Endpunkte der Ebenen

Ebenen auflisten

Gibt eine paginierte Liste von Ebenen in Vorrangreihenfolge zurück: höchste priority zuerst, innerhalb einer Priorität die neueste Ebene zuerst. Jede Ebene hat folgende Struktur:
  • is_default: ob dies die Standardebene des Kontos ist.
  • cycle_acu_limit: das Standard-ACU-Limit pro Abrechnungszyklus für jeden Member; null bedeutet keine Obergrenze.
  • policy: wie Anfragen zur Erhöhung des Limits für die Ebene behandelt werden — unconditional und conditional genehmigen bis zu max_limit, manual erfordert eine Admin-Prüfung. Die Richtlinie conditional (effizienzbasierte automatische Genehmigung) muss separat aktiviert werden; wenden Sie sich an Ihr Account-Team.
  • max_limit: das maximale Limit, bis zu dem Erhöhungsanfragen genehmigt werden; null genehmigt ohne Obergrenze. Immer null, wenn cycle_acu_limit null ist.
  • priority: ordnet die einem Nutzer über IdP-Gruppen zugeordneten Ebenen — der höchste Wert hat Vorrang; bei Gleichstand entscheidet die neueste Ebene. Die Rangfolge bestimmt lediglich den Vorrang: Eine Ebene mit höherer Priorität kann ein niedrigeres cycle_acu_limit haben. Eine explizite Nutzerzuweisung überschreibt diese Rangfolge, und die Standardebene wird nie eingestuft.
  • member_count: die Anzahl der Nutzer, die sich aktuell in der Ebene befinden — explizit zugewiesene Nutzer sowie Nutzer, die über eine IDP-Gruppenzuordnung zugeordnet wurden. Für die Standardebene werden alle Konto-Member gezählt, die keiner anderen Ebene angehören.
Konfigurieren Sie die Standardebene und die Ebenenpriorität in der Web-App unter Nutzungsrichtlinien.

Eine Ebene erstellen

Request-Body
Die erste Ebene des Kontos wird automatisch zur Standardebene. Gibt HTTP 201 und die erstellte Ebene zurück.

Eine Ebene abrufen

Eine Ebene aktualisieren

Teilaktualisierung; nicht angegebene Felder bleiben unverändert. Um die Standardebene oder die Priorität einer Ebene zu ändern, verwenden Sie die Web-App unter Nutzungsrichtlinien.

Eine Ebene löschen

Gibt bei Erfolg HTTP 204 zurück. Die Standardebene kann nicht gelöscht werden (stufen Sie zuerst eine andere Ebene hoch). Einer Ebene mit noch zugewiesenen Nutzern müssen diese zunächst entzogen werden, und alle IdP-Gruppenzuordnungen zu dieser Ebene müssen ebenfalls zuerst entfernt werden.

Nutzer-Endpunkte auf Ebene

Nutzer einer Ebene auflisten

Gibt eine paginierte Liste der Nutzer dieser Ebene mit ihren ermittelten Limits zurück — explizit zugewiesene Nutzer sowie Nutzer, die über eine IdP-Gruppenzuordnung zugeordnet wurden. Für die Standardebene umfasst dies alle Account-Member, die keiner anderen Ebene angehören:
  • cycle_acu_limit_override: die permanente Überschreibung des Nutzers, falls vorhanden.
  • temporary_cycle_acu_limit: die temporäre Überschreibung des Nutzers, die nur während des aktuellen monatlichen Zeitfensters aktiv ist.
  • effective_cycle_acu_limit: das aktuell für den Nutzer geltende Limit; null bedeutet ohne Obergrenze.
  • limit_source: die Herkunft des effektiven Limits — override (permanent), temporary_override oder tier.
  • membership: warum der Nutzer dieser Ebene angehört — explicit (direkt zugewiesen), idp_group (über seine maßgebliche IdP-Gruppenzuordnung) oder default (Rückfall auf die Standardebene).

Einen Nutzer einer Ebene zuordnen

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

Einen Nutzer aus einer Ebene entfernen

Entfernt die explizite Ebenenzuweisung des Nutzers (und alle Überschreibungen) und setzt ihn auf die Standardebene zurück. Gibt bei Erfolg HTTP 204 zurück.

Endpunkt für Nutzerüberschreibungen

Überschreibung eines Nutzers festlegen oder löschen

Nutzerbezogen: Das Ziel muss lediglich ein Konto-Member sein — es ist keine Ebene beteiligt, und die Ebenenzuweisung des Nutzers wird nie geändert. Ein Nutzer mit nur einer Überschreibung (ohne explizite Ebenenzuweisung) bleibt in der Standardebene. 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 Zeitfensters ab. Request-Body — alle Überschreibungen löschen
Der Endpunkt gibt bei Erfolg HTTP 204 zurück.

Endpunkte für IdP-Gruppen

Ordnen Sie eine IdP-Gruppe einer Ebene zu, damit ihre Member diese Ebene automatisch erben. Zuordnungen werden anhand der Gruppenmitgliedschaft live ermittelt und ändern niemals die explizite Ebenenzuweisung eines Nutzers – eine explizite Zuweisung hat immer Vorrang. Bei einem Nutzer in mehreren zugeordneten Gruppen wird die am höchsten eingestufte zugeordnete Ebene ermittelt (höchste Ebenen-priority; bei Gleichstand die neueste Ebene).

IDP-Gruppenzuordnungen auflisten

Gibt eine paginierte Liste der Gruppen-Ebenen-Zuordnungen des Kontos zurück, beginnend mit den ältesten. Mit ?tier_id= können Sie nur Gruppen auflisten, die einer Ebene zugeordnet sind:

IdP-Gruppenzuordnung einer IdP-Gruppe abrufen

Gibt HTTP 404 zurück, wenn der Gruppe keine IdP-Gruppenzuordnung zugewiesen ist.

Eine IdP-Gruppe einer Ebene zuordnen

Request-Body
Idempotentes Upsert. Eine Gruppe kann höchstens einer Ebene zugeordnet sein. Wird eine bereits zugeordnete Gruppe erneut zugeordnet, wird sie in die angegebene Ebene verschoben.

IdP-Gruppenzuordnung einer IDP-Gruppe aufheben

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

Endpunkte für Anfragen zur Erhöhung des Limits

Nutzer können ein höheres Limit pro Abrechnungszyklus anfordern. Die policy der Ebene des Antragstellers bestimmt, was geschieht: unconditional und conditional genehmigen Anfragen bis zum max_limit der Ebene automatisch, während manual die Anfrage zur Prüfung durch Admins über diese Endpunkte (oder unter Nutzungsrichtlinien in der Web-App) zurückstellt.
Anders als bei den anderen Endpunkten auf dieser Seite ist zum Abrufen von Anfragen zur Erhöhung des Limits die Berechtigung ManageBilling erforderlich — Anfragen enthalten die Identität von Membern und Freitextnachrichten, die Daten für Admin-Workflows darstellen.

Anfragen zur Erhöhung des Limits auflisten

Gibt eine paginierte Liste zurück, die nach ?status= (pending, approved, denied) und ?user_id= gefiltert werden kann:
  • tier_id / tier_name: die Ebene des Antragstellers (explizite Zuweisung, IdP-Gruppenzuordnung oder Standardebene); null, wenn das Konto keine Ebenen hat.
  • current_cycle_acu_limit: die aktuell für den Antragsteller geltende Obergrenze; null bedeutet, dass keine Obergrenze festgelegt ist.
  • reviewer: der Admin, der die Anfrage geprüft hat; null, solange die Anfrage aussteht.

Eine 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 Zeitfensters verfällt. Optional kann ein abweichendes Limit gewährt werden:
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, wenn sie bereits bearbeitet wurde.

Beispiel-Workflows

Ebenen mit einer Standardobergrenze einrichten

Erstellen Sie eine Standardebene, damit jeder Nutzer eine monatliche Obergrenze von 500 ACU erhält:
Erstellen Sie eine Ebene mit einem höheren Limit und weisen Sie ihr einen Nutzer zu:
Einem Nutzer für den Rest des Monats vorübergehend ein höheres Limit gewähren:
Ordnen Sie eine IdP-Gruppe der Ebene mit höherem Limit zu und prüfen Sie eine ausstehende Anfrage zur Erhöhung des Limits:

Häufig gestellte Fragen

Lokale und Cloud-Nutzung: Cloud-Devin-Sitzungen sowie die lokale Nutzung über die CLI und IDEs (Devin Desktop, Windsurf JetBrains und Devin CLI) werden auf dieselbe Obergrenze angerechnet.
Zuerst gilt eine dauerhafte Überschreibung, dann eine aktive temporäre Überschreibung, anschließend das Limit der dem Nutzer explizit zugewiesenen Ebene, danach das Limit der ihm über IdP-Gruppen zugeordneten am höchsten eingestuften Ebene und zuletzt das Limit der Standardebene. Ein null-Limit auf jeder Ebene bedeutet, dass der Nutzer keine Obergrenze hat.
Nein. Eine Überschreibung ersetzt das Ebenenlimit für diesen Nutzer. Beträgt das Ebenenlimit 500 ACUs und hat ein Nutzer eine Überschreibung von 200 ACUs, liegt sein effektives Limit bei 200 ACUs.
Eine dauerhafte Überschreibung läuft nie ab. Eine temporäre Überschreibung läuft am Ende des aktuellen monatlichen Zeitfensters ab. Danach gilt wieder das Limit der Ebene des Nutzers. Die Genehmigung einer Anfrage zur Erhöhung des Limits gewährt eine temporäre Überschreibung.
Nicht als eigenständige Einstellung. Konfigurieren Sie stattdessen das Limit der Standardebene — es gilt für jedes Konto-Member, das keiner anderen Ebene zugewiesen ist. Die Legacy-Endpunkte für das Standardlimit pro Nutzer lesen und schreiben jetzt das Limit der Standardebene.
Neue Arbeit wird sowohl lokal als auch in der Cloud blockiert. Der Nutzer kann sich an einen Enterprise-Administrator wenden, um das Limit anzupassen, oder warten, bis das nächste monatliche Zeitfenster beginnt.