Limits und Kontingente

In diesem Leitfaden finden Sie Informationen zu Limits und Kontingenten für die Data Manager API.

Projektbeschränkungen

Sie benötigen ein Google Cloud-Projekt, um die Data Manager API verwenden zu können. Das Google Cloud-Projekt enthält den OAuth-Client und die Anmeldedaten, die Sie zum Authentifizieren von API-Anfragen verwenden.

Für die Data Manager API gelten Ratenbegrenzungen für jedes Google Cloud-Projekt, getrennt nach Dienst und Vorgangstyp (Lesen im Vergleich zu Ändern):

Dienst Vorgang Anfragen pro Tag Anfragen pro Minute
IngestionService Ändern (schreiben) 100.000 300
IngestionService Lesen 100.000 300
Alle anderen Dienste zusammen Ändern (schreiben) 50.000 300
Alle anderen Dienste zusammen Lesen 50.000 300

Anfragen, die die Limits überschreiten, werden mit dem Fehler RESOURCE_EXHAUSTED und dem HTTP-Status 429 Too Many Requests abgelehnt.

Sie können die Kontrolle über Ihre App übernehmen und Ratenbeschränkungen umgehen, indem Sie sowohl die Anzahl der Anfragen aktiv reduzieren als auch die QPS auf Clientseite drosseln. Sie können auch Kontingentbenachrichtigungen und ‑überwachung in der Google Cloud Console einrichten, um Benachrichtigungen zu erhalten, bevor Ihre Anwendung ihre Limits erreicht.

Kontingentnamen

Jedes Limit entspricht einem Kontingentlimitnamen und einer Messwert in Google Cloud. Wenn eine Anfrage ein Limit überschreitet, gibt die Data Manager API den Namen des Kontingentlimits in der Standarddetailnutzlast ErrorInfo unter metadata.quota_limit zurück:

Name des Kontingentlimits Dienst Vorgang Fenster Limit
IngestionMutateRequestsPerDayPerProject IngestionService Änderung vorgenommen Tag 100.000
IngestionMutateRequestsPerMinutePerProject IngestionService Änderung vorgenommen Minute 300
IngestionReadRequestsPerDayPerProject IngestionService Lesen Tag 100.000
IngestionReadRequestsPerMinutePerProject IngestionService Lesen Minute 300
ManagementMutateRequestsPerDayPerProject Alle anderen Dienste Änderung vorgenommen Tag 50.000
ManagementMutateRequestsPerMinutePerProject Alle anderen Dienste Änderung vorgenommen Minute 300
ManagementReadRequestsPerDayPerProject Alle anderen Dienste Lesen Tag 50.000
ManagementReadRequestsPerMinutePerProject Alle anderen Dienste Lesen Minute 300

Sehen Sie sich metadata.quota_limit in der Nutzlast ErrorInfo an, um zwischen Fehlern aufgrund des Tageslimits und des Limits pro Minute zu unterscheiden und zu entscheiden, ob Sie die Ausführung vorübergehend unterbrechen und mit Backoff noch einmal versuchen oder bis zum Zurücksetzen des Tageskontingents warten sollten. Weitere Informationen finden Sie unter Fehler bei Kontingenten und Ratenlimits.

Anfragelimits

Hier sind die Limits für bestimmte Anfragen: