In diesem Dokument sind die Ratenkontingente und Systemlimits für Compute Engine aufgeführt, die die Anzahl der Anfragen angeben, die Sie an Compute Engine API-Methoden senden können.
Kontingente schränken ein, wie viel von einer Cloud de Confiance by S3NS -Ressource Ihr Projekt nutzen kann. Wenn Sie den Kontingentwert ändern möchten, um mehr Ressourcen zu nutzen, können Sie eine Kontingentanpassung anfordern. Systemlimits sind feste Einschränkungen, die nicht erhöht oder verringert werden können. Weitere Informationen finden Sie unter Cloud-Kontingente – Übersicht.
Ratenkontingente und Systemlimits
Ratenkontingente (auch als 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 Cloud de Confiance Console verwenden, stellen Sie auch Anfragen an die API. Diese Anfragen werden auf Ihr Ratenkontingent angerechnet. Wenn Sie Dienstkonten für den Zugriff auf die API verwenden, zählt dies ebenfalls zu Ihrem Ratenkontingent.
Google erzwingt Ratenkontingente pro Minute für jede Gruppe. Wenn Ihr Projekt innerhalb von 60 Sekunden die maximale Anzahl von API-Anfragen erreicht, müssen Sie warten, bis das Ratenkontingent wieder aufgefüllt ist, bevor Sie weitere Anfragen in dieser Gruppe stellen.
Wenn ein Projekt beispielsweise um 10:00:15 Uhr ein Kontingentlimit erreicht, wird das Kontingent zu Beginn des nächsten synchronisierten Intervalls, z. B. um 10:01:00 Uhr, wieder aufgefüllt, anstatt sofort wieder aufgefüllt zu werden.
Wenn Ihr Projekt ein Ratenkontingent ü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 API-Kontingente 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 und Systemlimits für globale Methoden
In den folgenden Abschnitten sind die Kontingente aufgeführt, die die Anzahl der Anfragen definieren, die Sie an die globalen Compute Engine API-Methoden senden können.
Vereinfachte API-Kontingente und Systemlimits für globale Methoden
Um die Auffindbarkeit und Verwaltbarkeit des Compute Engine API-Kontingents zu verbessern, hatCloud de Confiance die Anzahl der Kontingentmesswerte reduziert, indem Messwerte in weniger Kontingente konsolidiert wurden. Diese vereinfachten Kontingentmesswerte bieten auch höhere Limits für jedes Kontingent.
Eine vollständige Liste der globalen Methoden und der Kontingentmesswerte, mit denen die Kosten der einzelnen Methoden erfasst werden, finden Sie in der Referenz zu Kontingentmesswerten der Compute Engine API.
In der folgenden Tabelle sind die vereinfachten API-Kontingente und ‑Messwerte für die Compute Engine API aufgeführt:
| Kontingent und Beschreibung | Messwertname |
|---|---|
Leseanfragen pro Minute (GlobalReadsPerMinutePerProject)Kontingent für globale get- und list-Methoden.
|
compute.googleapis.com/global_reads |
Schreibanfragen pro Minute (GlobalWritesPerMinutePerProject)Kontingent für globale Schreibmethoden, die nicht in anderen Kontingentmesswerten enthalten sind. |
compute.googleapis.com/global_writes |
Anfragen zur Cache-Entwertung pro Minute (GlobalCacheInvalidationRequestsPerMinutePerProject)Kontingent für globale UrlMapsService.InvalidateCache-Methoden.
|
compute.googleapis.com/global_cache_invalidation_requests |
In der folgenden Tabelle sind die Systemlimits und Messwerte für die Compute Engine API aufgeführt:
| Systemlimit und Beschreibung | Messwertname |
|---|---|
Anfragen pro Minute auflisten (GlobalListUsablePerMinutePerProject)Systemlimit für globale ListUsable-Methoden.
|
compute.googleapis.com/list_usable_requests |
Gefilterte Liste Kostenaufwand (ListRequestsFilterCostOverheadPerMinutePerProject)Systemlimit für globale Cloud de Confiance berechnet die Kontingentnutzung für diesen Messwert zusätzlich zu den Kontingenten für den Messwert |
compute.googleapis.com/filtered_list_cost_overheadRate pro Projekt: 750.000 Ressourcen, die pro Region und Minute aus den Listenanfragen herausgefiltert werden. Da das Kontingent für jeweils 10.000 Ressourcen berechnet wird, wird das Limit als 75 (750.000/10.000) angezeigt, wenn Sie dieses Kontingentlimit in der Cloud de Confiance Console abfragen. |
Anfragen pro Minute (GlobalRequestsPerMinutePerProject)Systemlimit für alle globalen Lese- und Schreibanfragen. |
compute.googleapis.com/global_requests |
Legacy-API-Kontingente und Systemlimits für globale Methoden
In der folgenden Tabelle sind alle Compute Engine API-Kontingente für globale Methoden aufgeführt.
| Kontingent und Beschreibung | Messwertname |
|---|---|
Abfragen pro Minute (defaultPerMinutePerProject)Kontingent für globale Auflistungs- und Änderungsmethoden, die nicht in anderen Kontingentmesswerten enthalten sind. Die folgenden
|
compute.googleapis.com/default |
Leseanfragen (Legacy) (ReadRequestsPerMinutePerProject)Kontingent für globale *.get-Methoden. |
compute.googleapis.com/read_requests |
Listenanfragen (ListRequestsPerMinutePerProject)Kontingent für globale *.list-Methoden. |
compute.googleapis.com/list_requests |
Leseanfragen für Vorgänge (OperationReadRequestsPerMinutePerProject)Kontingent für die Methode globalOperations.get. |
compute.googleapis.com/operation_read_requests |
Globale Mutationsanfragen für Ressourcen (GlobalResourceWriteRequestsPerMinutePerProject)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 |
Umfangreiche Mutationsanfragen (HeavyWeightWriteRequestsPerMinutePerProject)Kontingent für die Methoden patch, delete und insert für die interconnects-Ressourcen. |
compute.googleapis.com/heavy_weight_write_requests |
Umfangreiche Leseanfragen (HeavyWeightReadRequestsPerMinutePerProject)Kontingent für *.aggregatedList-Methoden. |
compute.googleapis.com/heavy_weight_read_requests |
Die folgenden Kontingente gelten für globale APIs mit methodenspezifischen Kontingenten:
| Kontingent und Beschreibung | Messwertname | Standardbegrenzung |
|---|---|---|
| Lizenzeinfügeanfragen Kontingente für die licenses.insert-Methode. |
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 und Systemlimits für regionale und zonale Methoden
In den folgenden Abschnitten sind alle Kontingente aufgeführt, die für Methoden mit regionalen Messwerten gelten.
Vereinfachte API-Kontingente und -Limits für regionale und zonale Methoden
In der folgenden Tabelle sind die vereinfachten API-Kontingentmesswerte für regionale und zonale Compute Engine API-Methoden aufgeführt. Eine vollständige Liste der regionalen und zonalen Methoden sowie der Kontingentmesswerte, mit denen die Nutzung der einzelnen Methoden erfasst wird, finden Sie in der Referenz zu Compute Engine API-Kontingentmesswerten.
| Kontingent und Beschreibung | Messwertname |
|---|---|
Leseanfragen pro Minute und Region (ReadRequestsPerMinutePerProjectPerRegion)Kontingent für regionale und zonale „get“- und „list“-Methoden. |
compute.googleapis.com/reads_per_region |
Schreibanfragen pro Region (WritesPerMinutePerProjectPerRegion)Kontingent für regionale und zonale Schreibmethoden, die nicht in anderen Kontingentmesswerten enthalten sind. |
compute.googleapis.com/writes_per_region |
In der folgenden Tabelle sind die Systemlimits für regionale und zonale Methoden der Compute Engine API aufgeführt:
| Systemlimit und Beschreibung | Messwertname |
|---|---|
Anfragen pro Region auflisten (ListUsablePerMinutePerProjectPerRegion)Systemlimit für regionale und zonale ListUsable-Methoden.
|
compute.googleapis.com/list_usable_requests_per_region |
| Gefilterte Liste Kostenaufwand pro Region Systemlimit für regionale und zonale Cloud de Confiance berechnet die Kontingentnutzung für diesen Messwert zusätzlich zu den Kontingenten für den Messwert |
compute.googleapis.com/filtered_list_cost_overhead_per_regionRate pro Projekt ( ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion):
750.000 Ressourcen, die pro Region und Minute aus den Listenanfragen herausgefiltert werden. Da das Kontingent pro 10.000 Ressourcen berechnet wird, wird das Limit als 75 (750.000/10.000) angezeigt, wenn Sie dieses Kontingentlimit in der Cloud de Confiance Console abfragen.
|
Anfragen pro Minute und Region (RequestsPerMinutePerProjectPerRegion)Systemlimit für alle regionalen Lese- und Schreibanfragen. |
compute.googleapis.com/requests_per_region |
Legacy-API-Kontingente und Systemlimits für regionale Methoden
In der folgenden Tabelle sind alle Compute Engine API-Kontingente für regionale und zonale Methoden aufgeführt.
| Kontingent und Beschreibung | Messwertname |
|---|---|
Abfragen (QueriesPerMinutePerRegion)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
|
compute.googleapis.com/default_per_region |
Leseanfragen (Legacy) (ReadRequestsPerMinutePerRegion)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 |
Auflistungsanfragen (ListRequestsPerMinutePerRegion)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 |
Leseanfragen für Vorgänge (OperationReadRequestsPerMinutePerRegion)Kontingent für die Methoden regionOperations.get und zoneOperations.get. |
compute.googleapis.com/operation_read_requests_per_region |
Globale Mutationsanfragen für Ressourcen pro Region (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)Kontingent für die Methoden disks.createSnapshot und regionDisks.createSnapshot. |
compute.googleapis.com/global_resource_write_requests_per_region |
Anfragen zum Abrufen der Ausgabe serieller Ports für Instanzen (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)Kontingent für die Methode instances.getSerialPortOutput. |
compute.googleapis.com/get_serial_port_output_requests_per_region |
Komplexe Leseanfragen (HeavyWeightReadRequestsPerMinutePerRegion)Kontingent für die Methoden regionOperations.wait, zoneOperations.wait und regionNetworkFirewallPolicies.getEffectiveFirewalls. |
compute.googleapis.com/heavy_weight_read_requests_per_region |
Umfangreiche Mutationsanfragen pro RegionHeavyWeightWriteRequestsPerMinutePerProjectPerRegionKontingent für die Methoden patch, delete und insert für die interconnectAttachments-Ressource und für die Methode networks.updatePeering. |
compute.googleapis.com/heavy_weight_write_requests_per_region |
Anfragen zum Simulieren von Wartungsereignissen für Instanzen (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)Kontingent für die Methode instances.simulateMaintenanceEvent. |
compute.googleapis.com/simulate_maintenance_event_requests_per_region |
Anfragen an die Liste der Verweis-URLs für Instanz InstanceListReferrersRequestsPerMinutePerProjectPerRegionKontingent für die Methode instances.listReferrers. |
compute.googleapis.com/instance_list_referrers_requests_per_region |
Schreibanfragen für Netzwerkendpunkt NetworkEndpointWriteRequestsPerMinutePerProjectPerRegionKontingent für die Methoden networkEndpointGroups.attachNetworkEndpoints und networkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/network_endpoint_write_requests_per_region |
Anfragen zur Netzwerkendpunktliste (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)Kontingent für die Methode networkEndpointGroups.listNetworkEndpoints. |
compute.googleapis.com/network_endpoint_list_requests_per_region |
Schreibanfragen für regionale Netzwerkendpunkte (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)Kontingent für die Methoden regionNetworkEndpointGroups.attachNetworkEndpoints und regionNetworkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
Auflistungsanfragen für regionale Netzwerkendpunkte (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)Kontingent für die Methode regionNetworkEndpointGroups.listNetworkEndpoints. |
compute.googleapis.com/regional_network_endpoint_list_requests_per_region |
In der folgenden Tabelle sind die Limits für Legacy-Systeme für regionale und zonale Methoden der Compute Engine API aufgeführt:
| Systemlimit und Beschreibung | Messwertname |
|---|---|
| Gefilterte Liste Kostenaufwand Systemlimit für die Methoden Cloud de Confiance berechnet die Kontingentnutzung für diesen Messwert zusätzlich zu den Kontingenten für die Messwerte |
compute.googleapis.com/filtered_list_cost_overhead_per_regionRate pro Projekt ( ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion):
750.000 Ressourcen, die pro Region und Minute aus den Listenanfragen herausgefiltert werden. Da das Kontingent pro 10.000 Ressourcen berechnet wird, wird das Limit als 75 (750.000/10.000) angezeigt, wenn Sie dieses Kontingentlimit in der Cloud de Confiance Console abfragen.
|
Erhöhung der Ratenkontingente anfordern
Wenn Sie ein höheres Kontingent für API-Anfragen benötigen, können Sie in der Cloud de Confiance Console eine Erhöhung des API-Kontingents anfordern. Eine Anleitung finden Sie unter Kontingentanpassung 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.