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 inviare ai metodi dell'API Compute Engine.

Le quote limitano la quantità di una Cloud de Confiance by S3NS risorsa che il tuo 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 ulteriori informazioni, consulta la panoramica di Quote 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 a livello di progetto. Ogni quota si applica a un gruppo di uno o più metodi dell'API Compute Engine. Quando utilizzi gcloud CLI o la Cloud de Confiance console, effettui anche richieste all'API e queste richieste vengono conteggiate ai fini della quota di frequenza. Se utilizzi gli account di servizio per accedere all'API, anche questi vengono conteggiati 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 nel 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 inviare all'API Compute Engine è definito dalle quote API, come descritto nelle tabelle seguenti. Ogni gruppo viene conteggiato separatamente, quindi puoi raggiungere la quota massima in ogni gruppo contemporaneamente.

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 inviare 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, Cloud de Confiance 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 il 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 della 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 delle quote. 		compute.googleapis.com/global_writes
Richieste di invalidamento della cache al minuto (GlobalCacheInvalidationRequestsPerMinutePerProject)
Quota per i metodi globali UrlMapsService.InvalidateCache. 		compute.googleapis.com/global_cache_invalidation_requests

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

Limite di sistema e descrizione Nome della metrica
Elenca le richieste utilizzabili al minuto (GlobalListUsablePerMinutePerProject)
Limite di sistema per i metodi globali ListUsable. 		compute.googleapis.com/list_usable_requests
Overhead del costo dell'elenco filtrato (ListRequestsFilterCostOverheadPerMinutePerProject)

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

Cloud de Confiance addebita l'utilizzo della quota per questa metrica in aggiunta a le 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 fuori dalle richieste di elenco. 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 per ogni 10.000 risorse, il limite viene visualizzato come 75 (750.000/10.000) quando esegui una query per questo limite di quota nella Cloud de Confiance console.
Richieste al minuto (GlobalRequestsPerMinutePerProject)

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

 compute.googleapis.com/global_requests

Quote API e limiti di sistema legacy per i metodi globali

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

Quota e descrizione Nome della metrica
Query al minuto (defaultPerMinutePerProject)
Quota per i metodi di elenco e mutazione globali non inclusi in altre metriche delle 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 globali *.get methods.		 compute.googleapis.com/read_requests
Richieste di elenco (ListRequestsPerMinutePerProject)
Quota per i metodi globali *.list.		 compute.googleapis.com/list_requests
Richieste di lettura delle operazioni (OperationReadRequestsPerMinutePerProject)
Quota per globalOperations.get metodo.		 compute.googleapis.com/operation_read_requests
Richieste di mutazione 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 mutazione con peso elevato (HeavyWeightWriteRequestsPerMinutePerProject)
Quota per patch, delete, e insert metodi per le risorse interconnects.		 compute.googleapis.com/heavy_weight_write_requests
Richieste di lettura con peso elevato (HeavyWeightReadRequestsPerMinutePerProject)
Quota per *.aggregatedList metodi.		 compute.googleapis.com/heavy_weight_read_requests

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

Quota e descrizione Nome della metrica Limite predefinito
Richieste di inserimento delle 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 per giorno per progetto (LicenseInsertRequestsPerDayPerProject): 30 richieste/giorno
Richieste di impostazione dei metadati comuni delle istanze del progetto
Quota per projects.setCommonInstanceMetadata metodo.		 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 regionali e di zona

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

Quote e limiti API semplificati per i metodi regionali e di zona

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

Quota e descrizione Nome della metrica
Richieste di lettura al minuto per regione (ReadRequestsPerMinutePerProjectPerRegion)
Quota per i metodi regionali e di zona `get` e `list`.		 compute.googleapis.com/reads_per_region
Richieste di scrittura per regione (WritesPerMinutePerProjectPerRegion)
Quota per i metodi di scrittura regionali e di zona non inclusi in altre metriche delle quote. 		compute.googleapis.com/writes_per_region

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

Limite di sistema e descrizione Nome della metrica
Elenca le richieste utilizzabili per regione (ListUsablePerMinutePerProjectPerRegion)
Limite di sistema per i metodi regionali e di zona ListUsable 		compute.googleapis.com/list_usable_requests_per_region
Overhead del costo dell'elenco filtrato per regione

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

Cloud de Confiance Addebita l'utilizzo della quota per questa metrica in aggiunta a le 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 fuori dalle richieste di elenco. L'API Compute Engine rifiuta le richieste di elenco se superi questo limite.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
Frequenza per progetto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 risorse filtrate dalle richieste di elenco per regione al minuto. Poiché la quota viene addebitata per ogni 10.000 risorse, il limite viene visualizzato come 75 (750.000/10.000) quando esegui una query per questo limite di quota nella Cloud de Confiance console.
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 e limiti di sistema legacy per i metodi regionali

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

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

Anche i seguenti get, list e patch metodi 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 regionali e di zona get 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 regionali e di zona list methods such as autoscalers.list, disks.list, instances.list, and machineTypes.list.		 compute.googleapis.com/list_requests_per_region
Richieste di lettura delle operazioni (OperationReadRequestsPerMinutePerRegion)
Quota per regionOperations.get e zoneOperations.get metodi.		 compute.googleapis.com/operation_read_requests_per_region
Richieste di mutazione delle risorse globali per regione (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
Quota per disks.createSnapshot, e regionDisks.createSnapshot metodi.		 compute.googleapis.com/global_resource_write_requests_per_region
Richieste di 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 regionOperations.wait, zoneOperations.wait, e regionNetworkFirewallPolicies.getEffectiveFirewalls metodi.		 compute.googleapis.com/heavy_weight_read_requests_per_region
Richieste di mutazione con peso elevato per regione HeavyWeightWriteRequestsPerMinutePerProjectPerRegion
Quota per patch, delete, e insert metodi per interconnectAttachments risorsa e per il networks.updatePeering metodo.		 compute.googleapis.com/heavy_weight_write_requests_per_region
Richieste di simulazione dell'evento di manutenzione dell'istanza (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Quota per il metodo instances.simulateMaintenanceEvent.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region
Richieste di referenti dell'elenco delle istanze InstanceListReferrersRequestsPerMinutePerProjectPerRegion
Quota per il metodo instances.listReferrers.		 compute.googleapis.com/instance_list_referrers_requests_per_region
Richieste di scrittura degli endpoint di rete NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Quota per networkEndpointGroups.attachNetworkEndpoints e networkEndpointGroups.detachNetworkEndpoints metodi.		 compute.googleapis.com/network_endpoint_write_requests_per_region
Richieste di elenco degli endpoint di rete (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota per il metodo networkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/network_endpoint_list_requests_per_region
Richieste di scrittura degli endpoint di rete regionali (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Quota per regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints metodi.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Richieste di elenco degli endpoint di rete regionali (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 regionali e di zona dell'API Compute Engine:

Limite di sistema e descrizione Nome della metrica
Overhead del costo dell'elenco filtrato

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

Cloud de Confiance addebita l'utilizzo della quota per questa metrica in aggiunta 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 fuori dalle richieste di elenco. L'API Compute Engine rifiuta le richieste di elenco se superi questo limite.

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

Richiedi un aumento delle quote di frequenza

Se hai bisogno di una quota più elevata per effettuare richieste API, puoi richiedere un aumento della quota API dalla Cloud de Confiance console. Per le istruzioni, consulta Richiedi un aggiustamento della quota.

Best practice

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

Passaggi successivi