Compute Engine-Ratenkontingente

In diesem Dokument sind die Ratenkontingente für Compute Engine aufgeführt, mit denen die Anzahl der Anfragen definiert wird, 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 das 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 dargestellt. 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 Mutationsmethoden.

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 die Kontingentnutzung für diesen Messwert zusätzlich zu den Kontingenten für die Messwerte compute.googleapis.com/list_requests und compute.googleapis.com/heavy_weight_read_requests. Kontingentgebühren fallen an, wenn mehr als 10.000 gefilterte Ressourcen aus den Listenanfragen vorhanden sind. Die Compute Engine API lehnt die Listenanfragen ab, wenn Sie dieses Kontingentlimit überschreiten.

 compute.googleapis.com/filtered_list_cost_overheadBETA Begrenzung pro Projekt (ListRequestsFilterCostOverheadPerMinutePerProject): 750.000 gefilterte Ressourcen/Minute
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
Komplexe Leseanfragen
Kontingent für *.aggregatedList-Methoden.		 compute.googleapis.com/heavy_weight_read_requests Begrenzung pro Projekt (HeavyWeightReadRequestsPerMinutePerProject): 750 Anfragen/Minute

Für globale APIs mit Methodenkontingenten gelten die folgenden Kontingentgruppen:

Kontingentgruppe
Beschreibung		 Messwertname Standardbegrenzung
Anfragen zur Lizenzeinfügung
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 Messwert default_per_region:

  • 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 die Kontingentnutzung für diesen Messwert 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. Kontingentgebühren fallen an, wenn mehr als 10.000 gefilterte Ressourcen aus den Listenanfragen vorhanden sind. Die Compute Engine API lehnt die Listenanfragen ab, wenn Sie dieses Kontingentlimit überschreiten.

 compute.googleapis.com/filtered_list_cost_overhead_per_regionBETA Begrenzung pro Projekt (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 gefilterte Ressourcen/Minute
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 zum Auflisten von Verweis-URLs für Instanzen
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 Netzwerkendpunkte
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 eine Erhöhung des API-Kontingents über die Google Cloud Console 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 minimieren.

Nächste Schritte