Da die Google Vault API ein gemeinsam genutzter Dienst ist, wenden wir Kontingente und Beschränkungen an, um sicherzustellen, dass sie von allen Nutzern fair verwendet wird, und um den Gesamtzustand des Google Workspace-Systems zu schützen.
Produktlimits
Sie können in Ihrer Organisation maximal 20 Exporte ausführen.
API-Anfragekontingente
Jede Organisation darf 600 Rechtsangelegenheitslesevorgä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, Rechtsangelegenheit und gespeicherte Abfrage | 120 |
Halten | 228 |
Vorgang mit langer Ausführungszeit | 300 |
Schreibanfragen pro Minute und Projekt | |
---|---|
Exportieren | 20 |
Halten | 60 |
Berechtigungen für Rechtsangelegenheit | 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 wurde gelesen 1 Rechtsangelegenheit wurde geschrieben |
matters.count |
1 Zähler |
matters.get |
1 Rechtsangelegenheit gelesen |
matters.list |
10 Rechtsangelegenheiten |
matters.addPermissions matters.removePermissions
|
1 Rechtsangelegenheit lesen 1 Rechtsangelegenheit schreiben 1 Rechtsangelegenheitsberechtigung schreiben |
matters.exports.create |
1 Exportlesevorgang 10 Exportschreibvorgänge |
matters.exports.delete |
1 Exportschreibvorgang |
matters.exports.get |
1 Exportlesevorgang |
matters.exports.list |
5 Exportlesevorgänge |
matters.holds.addHeldAccounts matters.holds.create matters.holds.delete matters.holds.removeHeldAccounts matters.holds.update
|
1 Rechtsangelegenheit gelesen 1 Rechtsangelegenheit schreiben 1 Hold lesen 1 Hold-Schreibvorgang |
matters.holds.list |
1 Rechtsangelegenheitslesevorgang 3 Lesevorgänge auf Holds |
matters.holds.accounts.create matters.holds.accounts.delete matters.holds.accounts.list
|
1 Rechtsangelegenheit gelesen 1 Rechtsangelegenheit schreiben 1 Hold lesen 1 Hold-Schreibvorgang |
matters.savedQueries.create matters.savedQueries.delete
|
1 Rechtsangelegenheiten lesen 1 Rechtsangelegenheiten schreiben 1 gespeicherte Abfrage lesen 1 gespeicherte Abfrage schreiben |
matters.savedQueries.get |
1 Rechtsangelegenheiten lesen 1 gespeicherte Abfrage gelesen |
matters.savedQueries.list |
1 Rechtsangelegenheitslesevorgang 3 gespeicherte Abfragelesevorgänge |
operations.get |
1 Lesevorgang für lang andauernden Vorgang |
Zeitbasierte Kontingentfehler beheben
Wenn Sie ein Kontingent pro Minute oder pro Organisation überschreiten, erhalten Sie in der Regel den HTTP-Statuscode 429: Too many requests
.
Bei allen zeitbasierten Fehlern (maximal N Anfragen pro X Minuten) wird empfohlen, dass Ihr Code die Ausnahme abfängt und einen abgeschnittenen exponentiellen Backoff verwendet, damit Ihre Geräte keine übermäßige Last generieren.
Der exponentielle Backoff ist eine standardmäßige Fehlerbehandlungsstrategie für Netzwerkanwendungen. Ein exponentieller Backoff-Algorithmus wiederholt Anfragen mit exponentiell zunehmenden Wartezeiten zwischen Anfragen bis zu einer maximalen Backoff-Zeit. Wenn Anfragen weiterhin nicht erfolgreich sind, ist es wichtig, dass die Verzögerungen zwischen Anfragen im Laufe der Zeit zunimmt, bis die Anfrage erfolgreich ist.
Beispielalgorithmus
Ein exponentieller Backoff-Algorithmus wiederholt Anfragen exponentiell und verlängert dabei die Wartezeit zwischen Wiederholungen bis zur maximalen Backoff-Zeit. Beispiel:
- Stellen Sie eine Anfrage an die Google Vault API.
- Wenn die Anfrage fehlschlägt, warten Sie 1 +
random_number_milliseconds
und wiederholen Sie die Anfrage. - Wenn die Anfrage fehlschlägt, warten Sie „2 +
random_number_milliseconds
“ und wiederholen Sie die Anfrage. - Wenn die Anfrage fehlschlägt, warten Sie „4 +
random_number_milliseconds
“ und wiederholen Sie die Anfrage. - Und so weiter bis zur
maximum_backoff
-Zeit. - Warten Sie weiter und führen Sie Wiederholungsversuche bis zu einer bestimmten maximalen Anzahl von Wiederholungen durch, aber verlängern Sie nicht die Wartezeit zwischen den Wiederholungsversuchen.
Dabei gilt:
- Die Wartezeit beträgt
min(((2^n)+random_number_milliseconds), maximum_backoff)
, wobein
bei jedem Durchlauf (Anfrage) um 1 erhöht wird. random_number_milliseconds
ist eine zufällige Anzahl von Millisekunden,die kleiner oder gleich 1.000 ist. Dadurch wird vermieden, dass in bestimmten Situationen viele Clients synchronisiert werden und alle den Vorgang gleichzeitig wiederholen und Anfragen in synchronisierten Wellen senden. Der Wert vonrandom_number_milliseconds
wird nach jeder Wiederholungsanfrage neu berechnet.maximum_backoff
ist normalerweise 32 oder 64 Sekunden lang. Der geeignete Wert hängt vom 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 nach Erreichen dieses Werts alle 64 Sekunden einen neuen Versuch starten. An einem bestimmten Punkt sollten Clients daran gehindert werden, Wiederholungen unbegrenzt auszuführen.
Die Wartezeit zwischen den Wiederholungsversuchen und die Anzahl der Wiederholungsversuche hängen von Ihrem Anwendungsfall und Ihren Netzwerkbedingungen ab.
Kontingenterhöhung anfordern
Abhängig von der Ressourcennutzung Ihres Projekts können Sie eine Kontingenterhöhung anfordern. Bei API-Aufrufen durch ein Dienstkonto wird davon ausgegangen, dass sie ein einzelnes Konto nutzen. Die Beantragung eines höheren Kontingents garantiert keine Genehmigung. Die Genehmigung großer Kontingenterhöhungen kann länger dauern.
Es gelten nicht für alle Projekte dieselben Kontingente. Da Sie Google Cloud im Laufe der Zeit immer mehr nutzen, müssen Ihre Kontingente möglicherweise erhöht werden. Wenn Sie eine deutlich stärkere Auslastung erwarten, können Sie auf der Seite „Kontingente“ in der Google Cloud Console eine Anpassung Ihres Kontingents anfordern.
Weitere Informationen finden Sie in den folgenden Ressourcen:
- Informationen zu Anfragen zur Kontingenterhöhung
- Aktuelle Kontingentnutzung und ‐limits ansehen
- Höheres Kontingentlimit anfordern
Preise
Google Workspace-Kunden können die Google Vault API uneingeschränkt nutzen, ohne dass zusätzliche Kosten anfallen.