Limiti di utilizzo

Poiché l'API Google Vault è un servizio condiviso, applichiamo quote e limitazioni per assicurarci che venga utilizzata in modo equo da tutti gli utenti e per proteggere l'integrità complessiva del sistema Google Workspace.

Limiti di prodotto

Non puoi eseguire più di 20 esportazioni contemporaneamente in tutta l'organizzazione.

Quote per le richieste API

Ogni organizzazione può effettuare 600 letture di pratiche al minuto, in tutti i progetti e per tutti gli utenti, incluse le richieste tramite l'API Vault e vault.google.com.

Le tabelle seguenti elencano i limiti delle richieste al minuto per progetto:

Richieste di lettura al minuto per progetto
Esportazione, pratica e query salvata 120
Metti in pausa 228
Operazione a lunga esecuzione 300
Richieste di scrittura al minuto per progetto
Esporta 20
Metti in pausa 60
Autorizzazioni per le pratiche 30
Pratica 60
Query salvata 45
Richieste di ricerca (conteggio) al minuto per progetto
Conteggi di ricerca 20

Utilizzo della quota per metodo

La quota utilizzata da una richiesta dipende dal metodo chiamato. La tabella seguente elenca l'utilizzo della quota per metodo:

Metodo Costi della quota
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		1 pratica letta
1 pratica scritta
matters.count 1 unità
matters.get 1 pratica letta
matters.list 10 pratiche lette
matters.addPermissions
matters.removePermissions 		1 pratica letta
1 pratica scritta
1 scrittura delle autorizzazioni per le pratiche
matters.exports.create 1 esportazione letta
10 esportazioni scritte
matters.exports.delete 1 esportazione scritta
matters.exports.get 1 esportazione letta
matters.exports.list 5 esportazioni scritte
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 pratica letta
1 pratica scritta
1 sospensione letta
1 sospensione scritta
matters.holds.list 1 pratica letta
3 sospension lette
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 pratica letta
1 pratica scritta
1 sospensione letta
1 sospensione scritta
matters.savedQueries.create
matters.savedQueries.delete 		1 pratica letta
1 pratica scritta
1 query salvata letta
1 query salvata scritta
matters.savedQueries.get 1 pratica letta
1 query salvata letta
matters.savedQueries.list 1 pratica scritta
3 query salvate scritte
operations.get 1 operazione a lunga esecuzione scritta

Risolvere gli errori di quota basati sul tempo

Se superi una quota al minuto o per organizzazione, in genere ricevi una risposta con codice di stato HTTP 429: Too many requests.

Per tutti gli errori basati sul tempo (massimo N richieste ogni X minuti), ti consigliamo di fare in modo che il codice rilevi l'eccezione e utilizzi un backoff esponenziale troncato per assicurarti che i tuoi dispositivi non generino un carico eccessivo.

Il backoff esponenziale è una strategia standard di gestione degli errori per le applicazioni di rete. Un algoritmo di backoff esponenziale riprova le richieste utilizzando tempi di attesa tra le richieste che aumentano in modo esponenziale, fino a un tempo di backoff massimo. Se le richieste non vanno ancora a buon fine, è importante che i ritardi tra le richieste aumentino nel tempo fino a quando la richiesta non va a buon fine.

Algoritmo di esempio

Un algoritmo di backoff esponenziale riprova le richieste in modo esponenziale, aumentando il tempo di attesa tra i nuovi tentativi fino a un tempo di backoff massimo. Ad esempio:

  1. Invia una richiesta all'API Vault di Google.
  2. Se la richiesta non va a buon fine, attendi 1 + random_number_milliseconds e riprova la richiesta.
  3. Se la richiesta non va a buon fine, attendi 2 + random_number_milliseconds e riprova la richiesta.
  4. Se la richiesta non va a buon fine, attendi 4 + random_number_milliseconds e riprova la richiesta.
  5. E così via, fino a un tempo di maximum_backoff.
  6. Continua ad attendere e riprovare fino al numero massimo di nuovi tentativi, ma non aumentare il periodo di attesa tra i nuovi tentativi.

dove:

  • Il tempo di attesa è min(((2^n)+random_number_milliseconds), maximum_backoff), con n incrementato di 1 per ogni iterazione (richiesta).
  • random_number_milliseconds è un numero casuale di millisecondi minore o uguale a 1000. In questo modo, si evitano casi in cui molti client vengono sincronizzati da una determinata situazione e tutti riprovano contemporaneamente, inviando richieste in onde sincronizzate. Il valore di random_number_milliseconds viene ricalcolato dopo ogni nuova richiesta.
  • maximum_backoff è in genere 32 o 64 secondi. Il valore appropriato dipende dal caso d'uso.

Il client può continuare a riprovare dopo aver raggiunto il tempo maximum_backoff. I nuovi tentativi dopo questo punto non devono continuare ad aumentare il tempo di backoff. Ad esempio, se un client utilizza un valore maximum_backoff di 64 secondi, dopo aver raggiunto questo valore, il client può riprovare ogni 64 secondi. A un certo punto, è necessario impedire ai client di effettuare ulteriori tentativi indefinitamente.

Il tempo di attesa tra i nuovi tentativi e il numero di nuovi tentativi dipendono dal caso d'uso e dalle condizioni di rete.

Richiedi un aumento della quota

A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aggiustamento della quota. Le chiamate API di un account di servizio sono considerate come se utilizzassero un singolo account. La richiesta di una quota aggiustata non ne garantisce l'approvazione. L'approvazione delle richieste di aggiustamento della quota che aumenterebbero in modo significativo il valore della quota può richiedere più tempo.

Non tutti i progetti hanno le stesse quote. Man mano che utilizzi sempre più Google Cloud nel tempo, i valori delle quote potrebbero dover aumentare. Se prevedi un aumento imminente e consistente dell'utilizzo, puoi richiedere un aggiustamento della quota in modo proattivo nella pagina Quote e limiti di sistema della console Google Cloud.

Per saperne di più, consulta le seguenti risorse:

Prezzi

L'utilizzo dell'API Google Vault è disponibile senza costi aggiuntivi per i clienti Google Workspace.