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 API o quote API) definiscono il numero di richieste che possono essere effettuate all'API Compute Engine. Queste quote si applicano a livello di singolo progetto. Ogni quota si applica a un gruppo di uno o più metodi dell'API Compute Engine. Quando utilizzi gcloud CLI o la console Trusted Cloud , invii anche richieste all'API e queste richieste vengono conteggiate ai fini della quota di velocità. Se utilizzi account di servizio per accedere all'API, anche questi vengono conteggiati ai fini della quota di velocità.

Google applica le quote di frequenza a intervalli di un minuto (60 secondi) per ogni gruppo. Ciò significa che se il tuo progetto raggiunge il numero massimo di richieste API in un periodo di 60 secondi, devi attendere che la quota di velocità venga ripristinata prima di effettuare altre richieste nel gruppo. 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 ripristinata 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 per i metodi globali

Le sezioni seguenti elencano le quote che definiscono il numero di richieste che puoi inviare 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, Trusted 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 tutte le metriche semplificate delle quote API per l'API Compute Engine:

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

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

Trusted Cloud addebita l'utilizzo della quota per questa metrica in aggiunta 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
Tasso 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 visualizzato è 75 (750.000/10.000) quando esegui una query per questo limite di quota nella console Trusted Cloud .
Richieste al minuto (GlobalRequestsPerMinutePerProject)

Quota per tutte le richieste globali di lettura e scrittura.

 compute.googleapis.com/global_requests

Quote API precedenti per i metodi globali

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

Quota
Descrizione della quota		 Nome metrica
Query al minuto (defaultPerMinutePerProject)
Quota per i metodi di elenco globale e di mutazione non inclusi in altre metriche di quota.

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.		 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 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 mutazione 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
Descrizione della 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 al secondo (150 richieste al minuto)
  • Quota al giorno per progetto (LicenseInsertRequestsPerDayPerProject): 30 richieste al giorno
Richieste di metadati di istanza comuni impostati per il progetto
Quota per il metodo projects.setCommonInstanceMetadata.		 compute.googleapis.com/project_set_common_instance_metadata_requests Quota per progetto (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 richieste al minuto

Quote di velocità per i metodi a livello di regione e zona

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

Quote API semplificate per i metodi regionali e zonali

La tabella seguente elenca 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 delle metriche di quota che monitorano l'utilizzo di ciascun metodo, consulta Riferimento per le metriche delle quote dell'API Compute Engine.

Quota
Descrizione della quota		 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 zona che non sono inclusi in altre metriche di quota. 		compute.googleapis.com/writes_per_region
Elenca le richieste utilizzabili per regione (ListUsablePerMinutePerProjectPerRegion)
Quota per i metodi ListUsable a livello di regione e zona. 		compute.googleapis.com/list_usable_requests_per_region
Overhead del costo dell'elenco filtrato per regione

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

Trusted Cloud addebita l'utilizzo della quota per questa metrica in aggiunta 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 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 di quota nella console Trusted Cloud .
Richieste al minuto per regione (RequestsPerMinutePerProjectPerRegion)

Quota per tutte le richieste di lettura e scrittura regionali.

 compute.googleapis.com/requests_per_region

Quote API precedenti per i metodi regionali

La tabella seguente elenca tutte le quote API Compute Engine per i metodi regionali e zonali.

Quota
Descrizione della quota		 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 regionali e zonali come autoscalers.list, disks.list, instances.list e machineTypes.list.		 compute.googleapis.com/list_requests_per_region
Overhead del costo dell'elenco filtrato

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

Trusted Cloud 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. 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 di quota nella console Trusted Cloud .
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 mutazione 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 output della porta seriale di recupero 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 mutazione 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 eventi di manutenzione simulati per istanza (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Quota per il metodo instances.simulateMaintenanceEvent.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region
Richieste di referrer 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 i metodi networkEndpointGroups.attachNetworkEndpoints e networkEndpointGroups.detachNetworkEndpoints.		 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 di endpoint di rete regionali (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Quota per i metodi regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints.		 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

Richiedi un aumento delle quote di velocità

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

Best practice

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

Passaggi successivi