Skip to main content
POST
Recupera la configurazione di utilizzo

Panoramica

Recupera il limite di credito add-on effettivo per utente della tua organizzazione. I limiti si applicano sempre per singolo utente. La risposta restituisce il limite effettivamente applicato al soggetto richiesto dopo aver unito la configurazione degli ambiti più ampi, non solo il limite configurato direttamente nell’ambito richiesto.

Richiesta

string
obbligatorio
La tua chiave di servizio con autorizzazione “Billing Read”

Configurazione dell’ambito (sceglierne uno)

boolean
Imposta su true per recuperare il limite per utente a livello di team
string
Recupera il limite per utente effettivo per un gruppo specifico, indicando l’ID del gruppo. Il risultato combina il limite a livello di team con l’eventuale override di questo gruppo e non tiene conto degli altri gruppi a cui un utente può appartenere né degli override a livello di utente.
string
Recupera il limite per utente effettivo per un utente specifico, indicandone l’indirizzo email. Il risultato combina il limite a livello di team, gli override di tutti i gruppi a cui l’utente appartiene ed eventuali override a livello di utente.
Per definire l’ambito, devi specificare uno tra team_level, group_id o user_email.

Richiesta di esempio - Recuperare il limite per utente a livello di team

Richiesta di esempio - GET del limite effettivo per utente di un gruppo

Richiesta di esempio - Recuperare il limite per utente effettivo di un utente

Risposta

integer
Il limite effettivo dei crediti add-on per il soggetto richiesto. Per gli ambiti di gruppo e utente, questo valore può essere ereditato da un ambito più ampio. Se questo campo non è presente nella risposta, non si applica alcun limite né nell’ambito richiesto né negli ambiti da cui eredita.
Questo endpoint non indica da quale ambito provenga il limite restituito. Una richiesta per recuperare il limite di un gruppo o di un utente può restituire un limite ereditato dal team (o, nel caso di un utente, da uno dei suoi gruppi) anche se nell’ambito richiesto non è configurato alcun override.

Esempio di risposta - Con limite attivo

Risposta di esempio - Nessun limite attivo

Risposte di errore

Scenari di errore comuni:
  • Chiave del servizio non valida o autorizzazioni insufficienti
  • Sono stati forniti più parametri ambito
  • Non è stato fornito alcun parametro ambito
  • ID del gruppo o email dell’utente non validi
  • Limite di richieste superato