Nutzungsbeschränkungen

Da die Google Vault API ein gemeinsamer Dienst ist, wenden wir Kontingente und Einschränkungen an, um sicherzustellen, dass sie von allen Nutzern fair verwendet wird, und um die allgemeine Integrität des Google Workspace-Systems zu schützen.

Produktlimits

Sie können innerhalb Ihrer Organisation maximal 20 Exporte gleichzeitig ausführen.

Kontingente für API-Anfragen

Jede Organisation darf 600 Matter-Lesevorgänge pro Minute über alle Projekte und Nutzer hinweg ausführen, einschließlich Anfragen über die Vault API und vault.google.com.

In den folgenden Tabellen sind die Anfragelimits pro Minute und Projekt aufgeführt:

Leseanfragen pro Minute und Projekt
Export, Vorgang und gespeicherte Abfrage 120
Halten 228
Vorgang mit langer Ausführungszeit 300
Schreibanfragen pro Minute und Projekt
Exportieren 20
Halten 60
Berechtigungen für Angelegenheiten 30
Matter 60
Gespeicherte Abfrage 45
Suchanfragen (Anzahl) pro Minute und Projekt
Anzahl der Suchanfragen 20

Kontingentnutzung nach Methode

Das von einer Anfrage verwendete Kontingent hängt von der aufgerufenen Methode ab. In der folgenden Tabelle ist die Kontingentnutzung pro Methode aufgeführt:

Methode Kontingentkosten
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		1 Rechtsangelegenheit gelesen
1 Rechtsangelegenheit geschrieben
matters.count 1 Zählung
matters.get 1 Rechtsangelegenheit gelesen
matters.list 10 Lesevorgänge für Rechtsangelegenheiten
matters.addPermissions
matters.removePermissions 		1 Matter-Lesevorgang
1 Matter-Schreibvorgang
1 Matter-Berechtigungsschreibvorgang
matters.exports.create 1 Export gelesen
10 Exportvorgänge zum Schreiben
matters.exports.delete 1 Export schreiben
matters.exports.get 1 Export gelesen
matters.exports.list 5 Exportlesevorgänge
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 Vorgang lesen
1 Vorgang schreiben
1 Hold lesen
1 Hold schreiben
matters.holds.list 1 Rechtsangelegenheit gelesen
3 Hold-Lesevorgänge
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 Vorgang lesen
1 Vorgang schreiben
1 Hold lesen
1 Hold schreiben
matters.savedQueries.create
matters.savedQueries.delete 		1 Vorgang gelesen
1 Vorgang geschrieben
1 gespeicherte Abfrage gelesen
1 gespeicherte Abfrage geschrieben
matters.savedQueries.get 1 Vorgang gelesen
1 gespeicherte Abfrage gelesen
matters.savedQueries.list 1 Lesevorgang für Angelegenheit
3 Lesevorgänge für gespeicherte Abfragen
operations.get 1 Lesevorgang für einen Vorgang mit langer Ausführungszeit

Zeitbasierte Kontingentfehler beheben

Wenn Sie ein Kontingent pro Minute oder pro Organisation überschreiten, erhalten Sie in der Regel eine Antwort mit dem HTTP-Statuscode 429: Too many requests.

Bei allen zeitbasierten Fehlern (maximal N Anfragen pro X Minuten) empfehlen wir, dass Ihr Code die Ausnahme abfängt und einen abgeschnittenen exponentiellen Backoff verwendet, um sicherzustellen, dass Ihre Geräte keine übermäßige Last erzeugen.

Exponentieller Backoff ist eine Standardstrategie zur Fehlerbehebung für Netzwerkanwendungen. Ein exponentieller Backoff-Algorithmus wiederholt Anfragen mit exponentiell zunehmenden Wartezeiten zwischen den Anfragen bis zur maximalen Backoff-Zeit. Wenn Anfragen weiterhin fehlschlagen, ist es wichtig, dass die Verzögerungen zwischen den Anfragen mit der Zeit zunehmen, bis die Anfrage erfolgreich ist.

Beispielalgorithmus

Ein exponentieller Backoff-Algorithmus wiederholt Anfragen exponentiell und verlängert dabei die Wartezeit zwischen zwei Wiederholungen bis zur maximalen Backoff-Zeit. Beispiel:

  1. Stellen Sie eine Anfrage an die Google Vault API.
  2. Wenn die Anfrage fehlschlägt, wartet das System 1 + random_number_milliseconds Sekunden und wiederholt dann die Anfrage.
  3. Wenn die Anfrage fehlschlägt, wartet das System 2 + random_number_milliseconds Sekunden und wiederholt dann die Anfrage.
  4. Wenn die Anfrage fehlschlägt, wartet das System 4 + random_number_milliseconds Sekunden und wiederholt dann die Anfrage.
  5. Und so weiter bis zur maximum_backoff-Zeit.
  6. Das System wartet weiter und führt erneute Versuche bis zu einer maximalen Anzahl an Wiederholungsversuchen aus, jedoch ohne den zeitlichen Abstand zwischen zwei Versuchen zu erhöhen.

Dabei gilt:

  • Die Wartezeit beträgt min(((2^n)+random_number_milliseconds), maximum_backoff), wobei n bei jeder Ausführung (Anfrage) um 1 erhöht wird.
  • random_number_milliseconds steht für eine zufällige Anzahl von Millisekunden,deren Wert größer oder gleich 1.000 ist. So lassen sich Situationen vermeiden, in denen viele Clients synchronisiert werden und alle gleichzeitig Anfragen wiederholen und diese in synchronisierten Wellen senden. Der Wert von random_number_milliseconds wird nach jeder Anfragewiederholung neu berechnet.
  • maximum_backoff ist normalerweise 32 oder 64 Sekunden lang. Der geeignete Wert hängt vom jeweiligen Anwendungsfall ab.

Der Client kann den Vorgang wiederholen, nachdem er die maximum_backoff-Zeit erreicht hat. Die Backoff-Zeit muss dabei nicht mehr verlängert werden. Wenn ein Client beispielsweise eine maximum_backoff-Zeit von 64 Sekunden verwendet, kann er den Vorgang nach Erreichen dieses Werts alle 64 Sekunden noch einmal versuchen. Sie sollten jedoch dafür sorgen, dass er dies nicht unbegrenzt tut.

Die Wartezeit zwischen den Wiederholungen und die Anzahl der Wiederholungen hängen von Ihrem Anwendungsfall und den Netzwerkbedingungen ab.

Kontingenterhöhung anfordern

Abhängig von der Ressourcennutzung Ihres Projekts können Sie eine Kontingentanpassung beantragen. API-Aufrufe durch ein Dienstkonto werden als Aufrufe über ein einzelnes Konto betrachtet. Wenn Sie ein angepasstes Kontingent beantragen, bedeutet dies nicht, dass Ihr Antrag auch genehmigt wird. Die Genehmigung von Anfragen zur Kontingentanpassung, die den Kontingentwert erheblich erhöhen würden, kann länger dauern.

Es gelten nicht für alle Projekte dieselben Kontingente. Wenn Sie Google Cloud im Laufe der Zeit häufiger nutzen, müssen Ihre Kontingentwerte möglicherweise erhöht werden. Falls Sie eine deutlich stärkere Auslastung erwarten, können Sie auf der Seite „Kontingente“ der Google Cloud Console eine Anpassung Ihres Kontingents anfordern.

Weitere Informationen finden Sie in den folgenden Ressourcen:

Preise

Die Verwendung der Google Vault API ist für Google Workspace-Kunden kostenlos.