Quote di tariffe di Compute Engine

Questo documento elenca le quote di frequenza di Compute Engine, che definiscono il numero di richieste che puoi inviare ai metodi dell'API Compute Engine.

Quote di frequenza

Le quote di frequenza (note anche come limiti di frequenza dell'API o 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 Google Cloud console, invii anche richieste all'API e queste richieste vengono conteggiate ai fini della quota tariffaria. Se utilizzi account di servizio per accedere all'API, questi vengono conteggiati anche ai fini della quota tariffaria.

Google applica le quote di frequenza a un intervallo di un minuto (60 secondi) per ogni gruppo. Ciò significa che se il tuo progetto raggiunge il numero massimo di richieste API in qualsiasi momento entro 60 secondi, devi attendere che la quota di tariffa venga reintegrata prima di effettuare altre richieste in quel gruppo. Se il tuo progetto supera una quota di tariffa, 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 reintegrata all'inizio dell'intervallo successivo.

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

Quote di frequenza per i metodi globali

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

Quote API semplificate 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 di quota raggruppandole in meno quote. Queste metriche di quota semplificate offrono anche limiti più elevati per ogni quota.

Per visualizzare un elenco completo dei metodi globali e delle metriche relative alle quote che monitorano il costo di ciascun metodo, consulta la documentazione di riferimento delle metriche relative alle quote dell'API Compute Engine.

La tabella seguente elenca tutte le metriche di quota API semplificate per l'API Compute Engine:

Quota
Descrizione quota		 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 nelle altre metriche relative alle quote. 		compute.googleapis.com/global_writes
Elenca le richieste utilizzabili al minuto (GlobalListUsablePerMinutePerProject)
Quota per i metodi ListUsable globali. 		compute.googleapis.com/list_usable_requests
Richieste di annullamento convalida della cache al minuto (GlobalCacheInvalidationRequestsPerMinutePerProject)
Quota per i metodi UrlMapsService.InvalidateCache globali. 		compute.googleapis.com/global_cache_invalidation_requests
Costo aggiuntivo dell'elenco filtrato (ListRequestsFilterCostOverheadPerMinutePerProject)

Quota per metodi globali *.list e *.aggregatedList con filtri.

Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote relative alla metrica compute.googleapis.com/global_reads. Gli addebiti per le quote vengono applicati se sono presenti più di 10.000 risorse escluse 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 al minuto per regione. Poiché la quota viene addebitata per ogni 10.000 risorse, il limite visualizzato è 75 (750.000/10.000) quando esegui una query per questo limite nella Google Cloud console.
Richieste al minuto (GlobalRequestsPerMinutePerProject)

Quota per tutte le richieste di lettura e scrittura globali.

 compute.googleapis.com/global_requests

Quote dell'API precedente per i metodi globali

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

Quota
Descrizione quota		 Nome metrica
Query al minuto (defaultPerMinutePerProject)
Quota per i metodi di mutazione e degli elenchi globali non inclusi nelle 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 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 mutazioni complesse (HeavyWeightWriteRequestsPerMinutePerProject)
Quota per i metodi patch, delete e insert per le risorse interconnects.		 compute.googleapis.com/heavy_weight_write_requests
Richieste di lettura complesse (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
Descrizione quota		 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 giornaliera per progetto (LicenseInsertRequestsPerDayPerProject): 30 richieste/giorno
Quota
per le richieste di metadati delle istanze comuni impostate dal progetto per il metodo projects.setCommonInstanceMetadata.		 compute.googleapis.com/project_set_common_instance_metadata_requests Quota per progetto (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 richieste/minuto

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

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

Quote API semplificate per i metodi a livello di regione e zona

Nella tabella seguente sono elencate tutte le quote semplificate per i metodi regionali e zonali dell'API Compute Engine. Per visualizzare un elenco completo dei metodi regionali e zonali e le metriche relative alle quote che monitorano l'utilizzo di ciascun metodo, consulta la pagina Riferimento alle metriche relative alle quote dell'API Compute Engine.

Quota
Descrizione quota		 Nome metrica
Richieste di lettura al minuto per regione (ReadRequestsPerMinutePerProjectPerRegion)
Quota per i metodi "get" e "list" regionali e zonali.		 compute.googleapis.com/reads_per_region
Richieste di scrittura per regione (WritesPerMinutePerProjectPerRegion)
Quota per i metodi di scrittura a livello di regione e zona che non sono inclusi nelle altre metriche relative alle quote. 		compute.googleapis.com/writes_per_region
Elenca le richieste utilizzabili per regione (ListUsablePerMinutePerProjectPerRegion)
Quota per i metodi ListUsable regionali e zonali. 		compute.googleapis.com/list_usable_requests_per_region
Costo di overhead dell'elenco filtrato per regione

Quota per metodi regionali e zonali *.list e *.aggregatedList con filtri.

Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote relative alla metrica compute.googleapis.com/reads_per_region. Gli addebiti per le quote vengono applicati se sono presenti più di 10.000 risorse escluse 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_per_region
Tariffa 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 visualizzato è 75 (750.000/10.000) quando esegui una query per questo limite nella Google Cloud console.
Richieste al minuto per regione (RequestsPerMinutePerProjectPerRegion)

Quota per tutte le richieste di lettura e scrittura a livello di regione.

 compute.googleapis.com/requests_per_region

Quote dell'API precedente per i metodi a livello di regione

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

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

I seguenti metodi get, list e patch utilizzano anche 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 zonali, 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 regionali e zonali, come autoscalers.list, disks.list, instances.list e machineTypes.list.		 compute.googleapis.com/list_requests_per_region
Costo di overhead dell'elenco filtrato

Quota per metodi *.list e *.aggregatedList con filtri.

Google Cloud addebita l'utilizzo della quota per questa metrica, oltre alle quote relative alle metriche compute.googleapis.com/list_requests_per_region e compute.googleapis.com/heavy_weight_read_requests_per_region. Gli addebiti per le quote vengono applicati se sono presenti più di 10.000 risorse escluse 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_per_region
Tariffa 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 visualizzato è 75 (750.000/10.000) quando esegui una query per questo limite nella Google Cloud console.
Richieste di lettura delle operazioni (OperationReadRequestsPerMinutePerRegion)
Quota per metodi regionOperations.get e zoneOperations.get.		 compute.googleapis.com/operation_read_requests_per_region
Richieste di mutazione delle risorse globali per regione (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
Quota per metodi disks.createSnapshot e regionDisks.createSnapshot.		 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 pesanti (HeavyWeightReadRequestsPerMinutePerRegion)
Quota per i metodi regionOperations.wait, zoneOperations.wait e regionNetworkFirewallPolicies.getEffectiveFirewalls.		 compute.googleapis.com/heavy_weight_read_requests_per_region
Richieste di mutazioni pesanti 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 simulazione di eventi di manutenzione dell'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 dell'endpoint di rete NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Quota per metodi networkEndpointGroups.attachNetworkEndpoints e networkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/network_endpoint_write_requests_per_region
Richieste di elenchi di endpoint di rete (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota per il metodo networkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/network_endpoint_list_requests_per_region
Richieste di scrittura per endpoint di rete regionale (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Quota per metodi regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Richieste di elenchi di endpoint di rete regionali (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota per il metodo regionNetworkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_list_requests_per_region

Richiedere un aumento delle quote tariffarie

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

Best practice

Segui le best practice per l'API Compute Engine per preservare le quote di frequenza per attenuare gli effetti delle quote di frequenza.

Passaggi successivi