ACU-Obergrenzen pro Nutzer

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

Lesen und verwalten Sie manuelle ACU-Überschreibungen pro Nutzer. Eine Überschreibung ersetzt die Gruppen-ACU-Limits des Nutzers, das Team-ACU-Limit begrenzt jedoch weiterhin die Gesamtnutzung des Teams – siehe ACU-Limits. 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`	Das für den Nutzer durchgesetzte Limit pro Nutzer: seine Überschreibung, falls eine festgelegt ist, andernfalls sein höchstes Gruppen-ACU-Limit. Wird weggelassen, wenn kein Limit gilt. Das Team-ACU-Limit ist nicht enthalten; es wird separat anhand der Gesamtnutzung des Teams geprüft.

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 die ACU-Überschreibung des Nutzers pro Zyklus fest. Der Wert darf nicht negativ sein; 0 verhindert, dass der Nutzer ACUs verbraucht.

boolean

Entfernt die individuelle Überschreibung des Nutzers, sodass wieder die ACU-Limits seiner Gruppen 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 ACU-Limits.

​ACU-Obergrenze eines Nutzers abrufen

​ACU-Obergrenze eines Nutzers festlegen oder aufheben

ACU-Obergrenze eines Nutzers abrufen

ACU-Obergrenze eines Nutzers festlegen oder aufheben