In diesem Dokument sind die Compute Engine-Ratenkontingente aufgeführt, die die Anzahl der Anfragen definieren, die Sie an Compute Engine API-Methoden senden können.
Ratenkontingente
Ratenkontingente (auch als API-Ratenbegrenzungem oder API-Kontingente bezeichnet) definieren die Anzahl der Anfragen, die an die Compute Engine API gesendet werden können. Diese Kontingente gelten pro Projekt. Jedes Kontingent gilt für eine Gruppe von einer oder mehreren Compute Engine API-Methoden. Wenn Sie die gcloud CLI oder die Google Cloud Console verwenden, stellen Sie auch Anfragen an die API. Diese Anfragen werden auf Ihr Ratenkontingent angerechnet. Dasselbe gilt für Zugriffe auf die API über Dienstkonten.
Google erzwingt Ratenkontingente pro Minute (60 Sekunden) für jede Gruppe. Wenn Ihr Projekt also innerhalb von 60 Sekunden die maximale Anzahl von API-Anfragen erreicht, müssen Sie warten, bis das Kontingent wieder aufgefüllt ist, bevor Sie weitere Anfragen in dieser Gruppe stellen. Wenn Ihr Projekt eine Ratenbegrenzung überschreitet, erhalten Sie einen 403-Fehler mit dem Grund rateLimitExceeded. Um diesen Fehler zu beheben, warten Sie eine Minute und wiederholen Sie dann die Anfrage. Das Kontingent sollte zu Beginn des nächsten Intervalls neu aufgefüllt werden.
Die Anzahl der Anfragen, die Sie an die Compute Engine API senden können, wird durch Kontingentgruppen definiert, wie in den folgenden Tabellen beschrieben. Jede Gruppe wird separat gezählt, sodass Sie das höchste Kontingent in jeder Gruppe gleichzeitig erreichen können.
Ratenkontingente für globale Messwerte
Die folgenden Kontingentgruppen gelten für alle Ressourcen, sofern nicht anders angegeben:
| Kontingentgruppe Beschreibung |
Messwertname | Standardkontingent |
|---|---|---|
| Abfragen Kontingent für globale Änderungsmethoden, die nicht unter „Andere Kontingentmesswerte“ aufgeführt sind. Dieser Messwert wird auch für die folgenden
|
compute.googleapis.com/default |
Kontingent pro Projekt (defaultPerMinutePerProject): 1.500 Anfragen/Minute |
| Leseanfragen Kontingent für globale *.get-Methoden. |
compute.googleapis.com/read_requests |
Kontingent pro Projekt (ReadRequestsPerMinutePerProject): 1.500 Anfragen/Minute |
| Auflistungsanfragen Kontingent für globale *.list-Methoden. |
compute.googleapis.com/list_requests |
Kontingent pro Projekt (ListRequestsPerMinutePerProject): 1.500 Anfragen/Minute |
| Leseanfragen für Vorgänge Kontingent für die Methode globalOperations.get. |
compute.googleapis.com/operation_read_requests |
Begrenzung pro Projekt (OperationReadRequestsPerMinutePerProject): 1.500 Anfragen/Minute |
| Gefilterte Liste Kostenaufwand Kontingent für die Methoden BeiGoogle Cloud wird die Kontingentnutzung für diesen Messwert zusätzlich zu den Kontingenten für die Messwerte |
compute.googleapis.com/filtered_list_cost_overhead |
Rate pro Projekt (ListRequestsFilterCostOverheadPerMinutePerProject): 750.000 Ressourcen, die pro Minute aus den Listenanfragen pro Region herausgefiltert werden. Da das Kontingent für alle 10.000 Ressourcen berechnet wird, wird in der Google Cloud Console ein Limit von 75 (750.000/10.000) angezeigt, wenn Sie nach diesem Kontingentlimit fragen.
|
| Globale Anfragen zum Ändern von Ressourcen Kontingent für die Methoden images.delete, images.deprecate, images.insert, images.setLabels, snapshots.delete, snapshots.insert, snapshots.setLabels, machineImages.insert und machineImages.delete. |
compute.googleapis.com/global_resource_write_requests |
Begrenzung pro Projekt (GlobalResourceWriteRequestsPerMinutePerProject): 375 Anfragen/Minute |
| Komplexe Änderungsanfragen Kontingent für die Methoden patch, delete und insert für die interconnects-Ressourcen. |
compute.googleapis.com/heavy_weight_write_requests |
Begrenzung pro Projekt (HeavyWeightWriteRequestsPerMinutePerProject): 750 Anfragen/Minute |
| Umfangreiche Leseanfragen Kontingent für *.aggregatedList-Methoden. |
compute.googleapis.com/heavy_weight_read_requests |
Begrenzung pro Projekt (HeavyWeightReadRequestsPerMinutePerProject): 750 Anfragen/Minute |
Die folgenden Kontingentgruppen gelten für globale APIs mit methodenspezifischen Kontingenten:
| Kontingentgruppe Beschreibung |
Messwertname | Standardbegrenzung |
|---|---|---|
| Lizenzeinfügeanfragen Kontingente für die Methode licenses.insert. |
compute.googleapis.com/license_insert_requests |
|
| Anfragen zum Festlegen häufiger Instanzmetadaten für Projekte Kontingent für die projects.setCommonInstanceMetadata-Methode. |
compute.googleapis.com/project_set_common_instance_metadata_requests |
Kontingent pro Projekt (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 Anfragen/Minute |
Ratenkontingente für regionale Messwerte
Die folgenden Kontingente gelten für Methoden mit regionalen Messwerten:
| Kontingentgruppe Beschreibung |
Messwertname | Standardkontingent Kontingent pro Projekt und Region |
|---|---|---|
| Abfragen Kontingent für regionale und zonale Methoden, mit denen Compute Engine-Ressourcen erstellt, geändert oder gelöscht werden. Beispiel: Methoden instances.insert, disks.update und instances.delete.
Dieser Messwert wird auch für die folgenden
|
compute.googleapis.com/default_per_region |
Queries per minute per region: 1500 |
| Leseanfragen Kontingent für regionale und zonale get-Methoden wie autoscalers.get, disks.get, instances.get und machineTypes.get. |
compute.googleapis.com/read_requests_per_region |
Read requests per minute per region: 1500 |
| Auflistungsanfragen Kontingent für regionale und zonale list-Methoden wie autoscalers.list, disks.list, instances.list und machineTypes.list. |
compute.googleapis.com/list_requests_per_region |
List requests per minute per region: 1500 |
| Gefilterte Liste Kostenaufwand Kontingent für die Methoden BeiGoogle Cloud wird die Kontingentnutzung für diesen Messwert zusätzlich zu den Kontingenten für die Messwerte |
compute.googleapis.com/filtered_list_cost_overhead_per_regionBETA |
Rate pro Projekt (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 Ressourcen, die pro Minute aus den Listenanfragen pro Region herausgefiltert werden. Da das Kontingent für alle 10.000 Ressourcen berechnet wird, wird in der Google Cloud Console ein Limit von 75 (750.000/10.000) angezeigt, wenn Sie nach diesem Kontingentlimit fragen.
|
| Leseanfragen für Vorgänge Kontingent für die Methoden regionOperations.get und zoneOperations.get. |
compute.googleapis.com/operation_read_requests_per_region |
Operation read requests per minute per region: 1500 |
| Globale Anfragen zum Ändern von Ressourcen pro Region Kontingent für die Methoden disks.createSnapshot und regionDisks.createSnapshot. |
compute.googleapis.com/global_resource_write_requests_per_region |
GlobalResourceWriteRequestsPerMinutePerProjectPerRegion: 375 |
| Anfragen zum Abrufen der Ausgabe serieller Ports für Instanzen Kontingent für die Methode instances.getSerialPortOutput. |
compute.googleapis.com/get_serial_port_output_requests_per_region |
GetSerialPortOutputRequestsPerMinutePerProjectPerRegion: 1500 |
| Umfangreiche Leseanfragen Kontingent für die Methoden regionOperations.wait, zoneOperations.wait und regionNetworkFirewallPolicies.getEffectiveFirewalls. |
compute.googleapis.com/heavy_weight_read_requests_per_region |
Heavyweight read requests per minute: 750 |
| Umfangreiche Änderungsanfragen pro Region Kontingent für die Methoden patch, delete und insert für die interconnectAttachments-Ressource und für die Methoden networks.updatePeering. |
compute.googleapis.com/heavy_weight_write_requests_per_region |
HeavyWeightWriteRequestsPerMinutePerProjectPerRegion: 750 |
| Anfragen zum Simulieren von Wartungsereignissen für Instanzen Kontingent für die Methode instances.simulateMaintenanceEvent. |
compute.googleapis.com/simulate_maintenance_event_requests_per_region |
SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion: 150 |
| Anfragen an die Liste der Verweis-URLs für Instanz Kontingent für die Methode instances.listReferrers. |
compute.googleapis.com/instance_list_referrers_requests_per_region |
InstanceListReferrersRequestsPerMinutePerProjectPerRegion: 3000 |
| Schreibanfragen für Netzwerkendpunkt Kontingent für die Methoden networkEndpointGroups.attachNetworkEndpoints und networkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/network_endpoint_write_requests_per_region |
NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 1500 |
| Auflistungsanfragen für Netzwerkendpunkt Kontingent für die Methode networkEndpointGroups.listNetworkEndpoints. |
compute.googleapis.com/network_endpoint_list_requests_per_region |
NetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500 |
| Schreibanfragen für regionale Netzwerkendpunkt Kontingent für die Methoden regionNetworkEndpointGroups.attachNetworkEndpoints und regionNetworkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 150 |
| Auflistungsanfragen für regionalen Netzwerkendpunkt Kontingent für die Methode regionNetworkEndpointGroups.listNetworkEndpoints. |
compute.googleapis.com/regional_network_endpoint_list_requests_per_region |
RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500 |
Erhöhung der Preiskontingente beantragen
Wenn Sie ein höheres Kontingent für API-Anfragen benötigen, können Sie über die Google Cloud Console eine Erhöhung des API-Kontingents beantragen. Weitere Informationen finden Sie unter Höheres Kontingentlimit anfordern.
Best Practices
Halten Sie sich an die Best Practices für das Beibehalten von Ratenkontingenten der Compute Engine API, um die Auswirkungen von Ratenkontingenten zu reduzieren.
Nächste Schritte
- Weitere Informationen zum Überwachen der API-Nutzung
- Weitere Informationen zum Einrichten von Kontingentbenachrichtigungen