Limiti ACU per utente

Questa documentazione è destinata alle distribuzioni federali di Devin. Torna alla documentazione di Devin

Leggi e gestisci gli override dei limiti ACU per utente. Un override a livello di utente ha precedenza sui limiti di team e gruppo. Per informazioni su come viene determinato il limite effettivo, consulta Limiti ACU. Questi endpoint sono disponibili solo nelle distribuzioni federali multi-tenant. Utilizzano Teams Read-Only per le letture e Teams Update per le scritture. Entrambi gli endpoint selezionano l’utente tramite un oggetto user contenente esattamente uno dei seguenti campi:

string

L’indirizzo email dell’utente.

string

L’ID stabile dell’utente, come restituito dall’API, ad esempio nelle righe relative a membri del gruppo o al consumo ACU.

Le chiavi di servizio con ambito di gruppo possono selezionare solo i membri correnti del gruppo assegnato; per gli altri utenti viene restituito not_found. Consulta la panoramica dell’API per informazioni sull’autenticazione e sugli errori. L’oggetto limite restituito da entrambi gli endpoint:

Campo	Descrizione
`user_id`	L’ID stabile dell’utente.
`email`	L’indirizzo email dell’utente.
`configured_cycle_acu_limit`	L’override diretto per utente, se impostato. Un valore di `0` indica che l’utente è bloccato. Omesso se non esiste alcun override.
`effective_cycle_acu_limit`	Il limite effettivamente applicato all’utente dopo aver combinato l’override con i limiti di team e gruppo. Omesso se non si applica alcun limite.

Ottieni il limite di ACU di un utente

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

Impostare o rimuovere il limite di ACU di un utente

POST /api/v1/UpdateUserAcuCap

È necessario fornire esattamente uno dei seguenti parametri:

number

Imposta l’override del limite di ACU per ciclo dell’utente. Deve essere non negativo; 0 impedisce all’utente di consumare ACU.

boolean

Rimuove l’override dell’utente, consentendo nuovamente l’applicazione dei limiti del team e del gruppo.

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
  }'

La risposta contiene l’oggetto cap aggiornato.

Un override utente pari a 0 blocca l’utente. L’API del gruppo di chiavi di servizio non accetta un limite di gruppo pari a zero: set_cycle_acu_limit deve essere positivo e clear_cycle_acu_limit rimuove l’override del gruppo. La specifica operazione del portale per il limite di gruppo interpreta 0 come rimozione del limite. Vedi Valori zero e non impostati.

​Ottieni il limite di ACU di un utente

​Impostare o rimuovere il limite di ACU di un utente

Ottieni il limite di ACU di un utente

Impostare o rimuovere il limite di ACU di un utente