Limiti ACU per utente

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

Leggi e gestisci gli override ACU manuali per utente. Un override sostituisce i limiti ACU di gruppo dell’utente, ma il limite ACU del team continua a porre un tetto all’utilizzo totale del team: 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 utente diretto, se impostato. Un valore di `0` indica che l’utente è bloccato. Omesso se non esiste alcun override.
`effective_cycle_acu_limit`	Il limite per utente applicato all’utente: il suo override, se impostato, altrimenti il suo limite ACU di gruppo più alto. Omesso se non si applica alcun limite. Non include il limite ACU del team, che viene verificato separatamente rispetto all’utilizzo totale del team.

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 ACU di un utente

POST /api/v1/UpdateUserAcuCap

È necessario fornire esattamente uno dei seguenti parametri:

number

Imposta l’override del limite 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 ACU del suo 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 Limiti ACU.

​Ottieni il limite di ACU di un utente

​Impostare o rimuovere il limite ACU di un utente

Ottieni il limite di ACU di un utente

Impostare o rimuovere il limite ACU di un utente