ACU-Obergrenzen pro Nutzer

Diese Dokumentation gilt für die Federal Deployments von Devin. Zurück zur Devin-Dokumentation

Lesen und verwalten Sie ACU-Obergrenzenüberschreibungen pro Nutzer. Eine Nutzerüberschreibung hat Vorrang vor Team- und Gruppenlimits – siehe ACU-Limits für Informationen dazu, wie das wirksame Limit ermittelt wird. Diese Endpunkte sind nur in mandantenfähigen Federal Deployments verfügbar. Für Lesevorgänge verwenden sie Teams Read-Only, für Schreibvorgänge Teams Update. Beide Endpunkte wählen den Nutzer über ein user-Objekt aus, das genau eines der folgenden Elemente enthält:

string

Die E-Mail-Adresse des Nutzers.

string

Die stabile ID des Nutzers, wie sie von der API zurückgegeben wird, zum Beispiel in Zeilen für Gruppenmitglieder oder den ACU-Verbrauch.

Auf Gruppen beschränkte Service-Schlüssel können nur aktuelle Member der ihnen zugewiesenen Gruppe auswählen; für andere Nutzer wird not_found zurückgegeben. Informationen zu Authentifizierung und Fehlern finden Sie in der API-Übersicht. Das von beiden Endpunkten zurückgegebene Obergrenzenobjekt:

Feld	Beschreibung
`user_id`	Die stabile ID des Nutzers.
`email`	Die E-Mail-Adresse des Nutzers.
`configured_cycle_acu_limit`	Die direkte Überschreibung pro Nutzer, falls eine festgelegt ist. Ein Wert von `0` bedeutet, dass der Nutzer blockiert ist. Wird weggelassen, wenn keine Überschreibung vorhanden ist.
`effective_cycle_acu_limit`	Die für den Nutzer tatsächlich durchgesetzte Obergrenze, nachdem die Überschreibung mit Team- und Gruppenlimits kombiniert wurde. Wird weggelassen, wenn kein Limit gilt.

ACU-Obergrenze eines Nutzers abrufen

POST /api/v1/GetUserAcuCap

curl -X POST https://<your-server>/api/v1/GetUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"}
  }'

{
  "cap": {
    "userId": "user_abc",
    "email": "dev@agency.gov",
    "configuredCycleAcuLimit": 25,
    "effectiveCycleAcuLimit": 25
  }
}

ACU-Obergrenze eines Nutzers festlegen oder aufheben

POST /api/v1/UpdateUserAcuCap

Genau einer der folgenden Werte muss angegeben werden:

number

Legt das ACU-Limit des Nutzers pro Zyklus fest. Der Wert darf nicht negativ sein; 0 verhindert, dass der Nutzer ACUs verbraucht.

boolean

Entfernt das individuelle Limit des Nutzers, sodass die Limits für Teams und Gruppen wieder gelten.

curl -X POST https://<your-server>/api/v1/UpdateUserAcuCap \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "your_service_key",
    "user": {"email": "dev@agency.gov"},
    "set_cycle_acu_limit": 25
  }'

Die Antwort enthält das aktualisierte cap-Objekt.

Eine Nutzerüberschreibung von 0 sperrt den Nutzer. Die API für Service-Schlüssel-Gruppen akzeptiert keine Gruppenobergrenze von null: set_cycle_acu_limit muss positiv sein, und clear_cycle_acu_limit entfernt die Gruppenüberschreibung. Die separate Operation für Gruppenlimits im Portal behandelt 0 als Aufhebung. Siehe Null- und nicht gesetzte Werte.

​ACU-Obergrenze eines Nutzers abrufen

​ACU-Obergrenze eines Nutzers festlegen oder aufheben

ACU-Obergrenze eines Nutzers abrufen

ACU-Obergrenze eines Nutzers festlegen oder aufheben