Quote di frequenza e limiti di sistema di Compute Engine

Questo documento elenca le quote di frequenza e i limiti di sistema di Compute Engine che specificano il numero di richieste che puoi effettuare ai metodi dell'API Compute Engine.

Le quote limitano la quantità di una risorsa Google Cloud che il progetto può utilizzare. Se vuoi modificare il valore della quota per consentire un maggiore utilizzo delle risorse, puoi richiedere un aggiustamento della quota. I limiti di sistema sono vincoli fissi che non possono essere aumentati o diminuiti. Per maggiori informazioni, consulta la panoramica delle quote di Cloud.

Quote di frequenza e limiti di sistema

Le quote di frequenza (note anche come quote API) definiscono il numero di richieste che possono essere effettuate all'API Compute Engine. Queste quote si applicano in base al progetto. Ogni quota si applica a un gruppo di uno o più metodi dell'API Compute Engine. Quando utilizzi gcloud CLI o la console Google Cloud , effettui anche richieste all'API e queste richieste vengono conteggiate ai fini della quota di frequenza. Se utilizzi i service account per accedere all'API, anche questo viene conteggiato ai fini della quota di frequenza.

Google applica le quote di frequenza a intervalli di un minuto per ogni gruppo. Se il tuo progetto raggiunge il numero massimo di richieste API entro 60 secondi, devi attendere che la quota di frequenza venga ricaricata prima di effettuare altre richieste in quel gruppo. Ad esempio, se un progetto raggiunge un limite di quota alle 10:00:15, la quota viene ricaricata all'inizio dell'intervallo sincronizzato successivo, ad esempio alle 10:01:00, anziché essere ricaricata immediatamente. Se il tuo progetto supera una quota di frequenza, ricevi un errore 403 con il motivo rateLimitExceeded. Per risolvere questo errore, attendi un minuto e riprova a inviare la richiesta. La quota dovrebbe essere ricaricata all'inizio dell'intervallo successivo.

Il numero di richieste che puoi effettuare all'API Compute Engine è definito dalle quote dell'API, come descritto nelle tabelle seguenti. Ogni gruppo viene conteggiato separatamente, quindi puoi raggiungere contemporaneamente la quota massima in ogni gruppo.

Quote di frequenza e limiti di sistema per i metodi globali

Le sezioni seguenti elencano le quote che definiscono il numero di richieste che puoi effettuare ai metodi globali dell'API Compute Engine.

Quote API e limiti di sistema semplificati per i metodi globali

Per migliorare la rilevabilità e la gestibilità della quota dell'API Compute Engine, Google Cloud ha ridotto il numero di metriche relative alle quote raggruppandole in un numero inferiore di quote. Queste metriche delle quote semplificate offrono anche limiti più elevati per ciascuna quota.

Per visualizzare un elenco completo dei metodi globali e delle metriche delle quote che monitorano il costo di ogni metodo, consulta Riferimento per le metriche delle quote dell'API Compute Engine.

La tabella seguente elenca le quote e le metriche API semplificate per l'API Compute Engine:

Quota e descrizione Nome metrica
Richieste di lettura al minuto (GlobalReadsPerMinutePerProject)
Quota per i metodi globali get e list.
compute.googleapis.com/global_reads
Richieste di scrittura al minuto (GlobalWritesPerMinutePerProject)
Quota per i metodi di scrittura globali non inclusi in altre metriche relative alle quote.
compute.googleapis.com/global_writes
Richieste di annullamento della convalida della cache al minuto (GlobalCacheInvalidationRequestsPerMinutePerProject)
Quota per i metodi UrlMapsService.InvalidateCache globali.
compute.googleapis.com/global_cache_invalidation_requests

La tabella seguente elenca i limiti e le metriche di sistema per l'API Compute Engine:

Limite di sistema e descrizione Nome metrica
Richieste di elenco utilizzabili al minuto (GlobalListUsablePerMinutePerProject)
Limite di sistema per i metodi ListUsable globali.
compute.googleapis.com/list_usable_requests
Overhead dei costi dell'elenco filtrato (ListRequestsFilterCostOverheadPerMinutePerProject)

Limite di sistema per i metodi globali *.list e *.aggregatedList con filtri.

Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote per la metrica compute.googleapis.com/global_reads. Vengono addebitati costi per la quota se le richieste di elenco contengono più di 10.000 risorse filtrate. L'API Compute Engine rifiuta le richieste di elenco se superi questo limite di quota.

compute.googleapis.com/filtered_list_cost_overhead
Frequenza per progetto: 750.000 risorse filtrate dalle richieste di elenco per regione al minuto. Poiché la quota viene addebitata ogni 10.000 risorse, il limite visualizzato è 75 (750.000/10.000) quando esegui una query per questo limite di quota nella console Google Cloud .
Richieste al minuto (GlobalRequestsPerMinutePerProject)

Limite di sistema per tutte le richieste di lettura e scrittura globali.

compute.googleapis.com/global_requests

Quote API legacy e limiti di sistema per i metodi globali

La tabella seguente elenca tutte le quote dell'API Compute Engine per i metodi globali.

Quota e descrizione Nome metrica
Query al minuto (defaultPerMinutePerProject)
Quota per i metodi di elenco e mutazione globali non inclusi in altre metriche relative alle quote.

Anche i seguenti metodi get utilizzano questa metrica default:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
compute.googleapis.com/default
Richieste di lettura (legacy) (ReadRequestsPerMinutePerProject)
Quota per i metodi *.get globali.
compute.googleapis.com/read_requests
Richieste di elenco (ListRequestsPerMinutePerProject)
Quota per i metodi *.list globali.
compute.googleapis.com/list_requests
Richieste di lettura delle operazioni (OperationReadRequestsPerMinutePerProject)
Quota per il metodo globalOperations.get.
compute.googleapis.com/operation_read_requests
Richieste di modifica delle risorse globali (GlobalResourceWriteRequestsPerMinutePerProject)
Quota per i metodi images.delete, images.deprecate, images.insert, images.setLabels, snapshots.delete, snapshots.insert, snapshots.setLabels, machineImages.insert e machineImages.delete.
compute.googleapis.com/global_resource_write_requests
Richieste di modifica pesanti (HeavyWeightWriteRequestsPerMinutePerProject)
Quota per i metodi patch, delete e insert per le risorse interconnects.
compute.googleapis.com/heavy_weight_write_requests
Richieste di lettura pesanti (HeavyWeightReadRequestsPerMinutePerProject)
Quota per i metodi *.aggregatedList.
compute.googleapis.com/heavy_weight_read_requests

Le seguenti quote si applicano alle API globali con quote per metodo:

Quota e descrizione Nome metrica Limite predefinito
Richieste di inserimento di licenze
Quote per il metodo licenses.insert.
compute.googleapis.com/license_insert_requests
  • Quota per progetto (LicenseInsertRequestsPerMinutePerProject): 2,5 richieste/secondo (150 richieste/minuto)
  • Quota al giorno per progetto (LicenseInsertRequestsPerDayPerProject): 30 richieste/giorno
Richieste di impostazione dei metadati di istanza comuni del progetto
Quota per il metodo projects.setCommonInstanceMetadata.
compute.googleapis.com/project_set_common_instance_metadata_requests Quota per progetto (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 richieste/minuto

Quote di frequenza e limiti di sistema per i metodi a livello di regione e di zona

Le sezioni seguenti elencano tutte le quote che si applicano ai metodi che utilizzano metriche regionali.

Quote e limiti API semplificati per i metodi a livello di regione e zona

La tabella seguente elenca le metriche semplificate delle quote API per i metodi regionali e zonali dell'API Compute Engine: Per visualizzare un elenco completo dei metodi regionali e zonali e delle metriche delle quote che monitorano l'utilizzo di ciascun metodo, consulta Riferimento per le metriche delle quote dell'API Compute Engine.

Quota e descrizione Nome metrica
Richieste di lettura al minuto per regione (ReadRequestsPerMinutePerProjectPerRegion)
Quota per i metodi "get" e "list" a livello di regione e zona.
compute.googleapis.com/reads_per_region
Richieste di scrittura per regione (WritesPerMinutePerProjectPerRegion)
Quota per i metodi di scrittura a livello di regione e di zona non inclusi in altre metriche di quota.
compute.googleapis.com/writes_per_region

La tabella seguente elenca i limiti di sistema per i metodi a livello di regione e di zona dell'API Compute Engine:

Limite di sistema e descrizione Nome metrica
Elenca le richieste utilizzabili per regione (ListUsablePerMinutePerProjectPerRegion)
Limite di sistema per i metodi ListUsable a livello di regione e zona.
compute.googleapis.com/list_usable_requests_per_region
Overhead dei costi dell'elenco filtrato per regione

Limite di sistema per i metodi a livello di regione e zona *.list e *.aggregatedList con filtri.

Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote per la metrica compute.googleapis.com/reads_per_region. Vengono addebitati costi per la quota se le richieste di elenco contengono più di 10.000 risorse filtrate. L'API Compute Engine rifiuta le richieste di elenco se superi questo limite.

compute.googleapis.com/filtered_list_cost_overhead_per_region
Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 risorse filtrate dalle richieste di elenco per regione al minuto. Poiché la quota viene addebitata ogni 10.000 risorse, il limite visualizzato è 75 (750.000/10.000) quando esegui una query per questo limite di quota nella console Google Cloud .
Richieste al minuto per regione (RequestsPerMinutePerProjectPerRegion)

Limite di sistema per tutte le richieste di lettura e scrittura regionali.

compute.googleapis.com/requests_per_region

Quote API legacy e limiti di sistema per i metodi regionali

La tabella seguente elenca tutte le quote dell'API Compute Engine per i metodi a livello di regione e di zona.

Quota e descrizione Nome metrica
Query (QueriesPerMinutePerRegion)
Quota per i metodi a livello di regione e zona che creano, modificano o eliminano risorse di Compute Engine. Ad esempio, i metodi instances.insert, disks.update e instances.delete.

Anche i seguenti metodi get, list e patch utilizzano questa metrica 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
Richieste di lettura (legacy) (ReadRequestsPerMinutePerRegion)
Quota per i metodi get regionali e di zona, come autoscalers.get, disks.get, instances.get e machineTypes.get.
compute.googleapis.com/read_requests_per_region
Richieste di elenco (ListRequestsPerMinutePerRegion)
Quota per i metodi list a livello di regione e di zona, come autoscalers.list, disks.list, instances.list e machineTypes.list.
compute.googleapis.com/list_requests_per_region
Richieste di lettura delle operazioni (OperationReadRequestsPerMinutePerRegion)
Quota per i metodi regionOperations.get e zoneOperations.get.
compute.googleapis.com/operation_read_requests_per_region
Richieste di modifica delle risorse globali per regione (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
Quota per i metodi disks.createSnapshot e regionDisks.createSnapshot.
compute.googleapis.com/global_resource_write_requests_per_region
Richieste di recupero dell'output della porta seriale dell'istanza (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)
Quota per il metodo instances.getSerialPortOutput.
compute.googleapis.com/get_serial_port_output_requests_per_region
Richieste di lettura con peso elevato (HeavyWeightReadRequestsPerMinutePerRegion)
Quota per i metodi regionOperations.wait, zoneOperations.wait e regionNetworkFirewallPolicies.getEffectiveFirewalls.
compute.googleapis.com/heavy_weight_read_requests_per_region
Richieste di modifica con peso elevato per regione HeavyWeightWriteRequestsPerMinutePerProjectPerRegion
Quota per i metodi patch, delete e insert per la risorsa interconnectAttachments e per il metodo networks.updatePeering.
compute.googleapis.com/heavy_weight_write_requests_per_region
Richieste di supporto per eventi di manutenzione simulati per l'istanza (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Quota per il metodo instances.simulateMaintenanceEvent.
compute.googleapis.com/simulate_maintenance_event_requests_per_region
Richieste di referrer dell'elenco di istanze InstanceListReferrersRequestsPerMinutePerProjectPerRegion
Quota per il metodo instances.listReferrers.
compute.googleapis.com/instance_list_referrers_requests_per_region
Richieste di scrittura di endpoint di rete NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Quota per i metodi networkEndpointGroups.attachNetworkEndpoints e networkEndpointGroups.detachNetworkEndpoints.
compute.googleapis.com/network_endpoint_write_requests_per_region
Richieste di elenco di endpoint di rete (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota per il metodo networkEndpointGroups.listNetworkEndpoints.
compute.googleapis.com/network_endpoint_list_requests_per_region
Richieste di scrittura di endpoint di rete a livello di regione (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Quota per i metodi regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints.
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Richieste di elenco di endpoint di rete a livello di regione (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota per il metodo regionNetworkEndpointGroups.listNetworkEndpoints.
compute.googleapis.com/regional_network_endpoint_list_requests_per_region

La tabella seguente elenca i limiti di sistema legacy per i metodi a livello di regione e di zona dell'API Compute Engine:

Limite di sistema e descrizione Nome metrica
Overhead dei costi dell'elenco filtrato

Limite di sistema per i metodi *.list e *.aggregatedList con filtri.

Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote per le metriche compute.googleapis.com/list_requests_per_region e compute.googleapis.com/heavy_weight_read_requests_per_region. Vengono addebitati costi per la quota se le richieste di elenco contengono più di 10.000 risorse filtrate. L'API Compute Engine rifiuta le richieste di elenco se superi questo limite.

compute.googleapis.com/filtered_list_cost_overhead_per_region
Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 risorse filtrate dalle richieste di elenco per regione al minuto. Poiché la quota viene addebitata ogni 10.000 risorse, quando esegui una query per questo limite di quota nella console Google Cloud , il limite visualizzato è 75 (750.000/10.000).

Richiedi un aumento delle quote di frequenza

Se hai bisogno di una quota maggiore per effettuare richieste API, puoi richiedere un aumento della quota API dalla console Google Cloud . Per le istruzioni, consulta Richiedi un aggiustamento delle quote.

Best practice

Segui le best practice dell'API Compute Engine per preservare le quote di frequenza e mitigare gli effetti delle quote di frequenza.

Passaggi successivi