Compute Engine-Ratenkontingente


In diesem Dokument sind die Ratenkontingente für Compute Engine 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 und 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 in anderen Kontingentmesswerten enthalten sind.

Die folgenden get-Methoden verwenden auch diesen default-Messwert:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
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 *.list und *.aggregatedList mit Filtern.

Google Cloud berechnet zusätzlich zu den Kontingenten für die Messwerte compute.googleapis.com/list_requests und compute.googleapis.com/heavy_weight_read_requests die Kontingentnutzung für diesen Messwert. Wenn mehr als 10.000 Ressourcen aus den Auflistunganfragen herausgefiltert werden, fallen Kontingentgebühren an. Die Compute Engine API lehnt die Auflistungsanfragen ab, wenn Sie dieses Kontingentlimit überschreiten.

compute.googleapis.com/filtered_list_cost_overhead Begrenzung pro Projekt (ListRequestsFilterCostOverheadPerMinutePerProject): 750.000 Ressourcen, die aus den Auflistungsanfragen pro Region und Minute herausgefiltert werden. Da das Kontingent für jeweils 10.000 Ressourcen berechnet wird, wird ein Limit von 75 (750.000/10.000) angezeigt, wenn Sie dieses Kontingentlimit in der Google Cloud Console abfragen.
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
  • Rate pro Projekt (LicenseInsertRequestsPerMinutePerProject): 2,5 Anfragen/Sekunde (150 Anfragen/Minute)
  • Rate pro Tag und Projekt (LicenseInsertRequestsPerDayPerProject): 30 Anfragen/Tag
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.

Die folgenden Methoden get, list und patch verwenden ebenfalls diesen default_per_region-Messwert:

  • projects.listXpnHosts
  • instances.getScreenshot
  • instances.getGuestAttributes
  • instances.getShieldedInstanceIdentity
  • instances.getEffectiveFirewalls
  • projects.listXpnHosts
  • instanceGroupManagers.listManagedInstances
  • instanceGroupManagers.listErrors
  • instanceGroupManagers.listPerInstanceConfigs
  • regionInstanceGroupManagers.listManagedInstances
  • regionInstanceGroupManagers.listErrors
  • regionInstanceGroupManagers.listPerInstanceConfigs
  • resourcePolicies.patch
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 *.list und *.aggregatedList mit Filtern.

Google Cloud berechnet zusätzlich zu den Kontingenten für die Messwerte compute.googleapis.com/list_requests_per_region und compute.googleapis.com/heavy_weight_read_requests_per_region die Kontingentnutzung für diesen Messwert. Wenn mehr als 10.000 Ressourcen aus den Auflistunganfragen herausgefiltert werden, fallen Kontingentgebühren an. Die Compute Engine API lehnt die Auflistungsanfragen ab, wenn Sie dieses Kontingentlimit überschreiten.

compute.googleapis.com/filtered_list_cost_overhead_per_regionBETA Begrenzung pro Projekt (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 Ressourcen, die aus den Auflistungsanfragen pro Region und Minute herausgefiltert werden. Da das Kontingent für jeweils 10.000 Ressourcen berechnet wird, wird ein Limit von 75 (750.000/10.000) angezeigt, wenn Sie dieses Kontingentlimit in der Google Cloud Console abfragen.
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
Komplexe 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

Höhere Ratenkontingente anfordern

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 anfordern. 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