Quote di frequenza di Compute Engine

Questo documento elenca le quote di frequenza di Compute Engine, che definiscono il numero che puoi effettuare 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 richieste che possono essere inviate all'API Compute Engine. Queste quote si applicano in base al singolo progetto. Ogni quota si applica a un gruppo di o più metodi dell'API Compute Engine. Quando utilizzi gcloud CLI o la console Google Cloud, invii anche richieste all'API e queste richieste vengono conteggiate ai fini della quota di frequenza. Se utilizzi account di servizio per accedere l'API, questo viene conteggiato ai fini della quota di frequenza.

Google applica le quote di frequenza a un intervallo di un minuto (60 secondi) per ogni gruppo. Ciò significa che se il progetto raggiunge il numero massimo di richieste API in qualsiasi momento entro 60 secondi, devi attendere il ricaricamento della quota di frequenza prima facendo più richieste in quel gruppo. Se il progetto supera una quota di frequenza, ricevono 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 effettuare all'API Compute Engine è definito da gruppi di quote come descritto nelle tabelle seguenti. Ogni gruppo viene conteggiato distintamente, quindi puoi raggiungere contemporaneamente la quota massima in ogni gruppo.

Quote di frequenza per le metriche globali

I seguenti gruppi di quote si applicano a tutte le risorse, se non diversamente specificato:

Gruppo di quote
Descrizione		 Nome metrica Quota predefinita
Query
Quota per i metodi di mutazione globali non inclusi in e altre metriche di quota.

Anche i seguenti metodi get utilizzano questa metrica default:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default Quota per progetto (defaultPerMinutePerProject): 1500 richieste/minuto
Richieste di lettura
Quota per metodi *.get globali.		 compute.googleapis.com/read_requests Quota per progetto (ReadRequestsPerMinutePerProject): 1500 richieste/minuto
Richieste di elenco
Quota per metodi *.list globali.		 compute.googleapis.com/list_requests Quota per progetto (ListRequestsPerMinutePerProject): 1500 richieste/minuto
Richieste di lettura delle operazioni
Quota per il metodo globalOperations.get.		 compute.googleapis.com/operation_read_requests Tariffa per progetto (OperationReadRequestsPerMinutePerProject): 1500 richieste/minuto
Overhead dei costi per elenco filtrato

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

Google Cloud addebita l'utilizzo della quota per questa metrica in aggiunta a le quote compute.googleapis.com/list_requests e Metriche compute.googleapis.com/heavy_weight_read_requests. 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 Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProject): 750.000 risorse filtrate dalle richieste di elenco per regione al minuto. Come di quota ogni 10.000 risorse, vedrai il limite di 75 (750.000/10.000) quando una query per il limite di quota sulla console Google Cloud.
Richieste di mutazione delle risorse globali
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 Tariffa per progetto (GlobalResourceWriteRequestsPerMinutePerProject): 375 richieste/minuto
Richieste di mutazioni pesanti
Quota per i metodi patch, delete e insert per le risorse interconnects.		 compute.googleapis.com/heavy_weight_write_requests Tariffa per progetto (HeavyWeightWriteRequestsPerMinutePerProject): 750 richieste/minuto
Richieste di lettura pesanti
Quota per i metodi *.aggregatedList.		 compute.googleapis.com/heavy_weight_read_requests Tariffa per progetto (HeavyWeightReadRequestsPerMinutePerProject): 750 richieste/minuto

I seguenti gruppi di quote si applicano alle API globali con quote per metodo:

Gruppo di quote
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 giornaliera per progetto (LicenseInsertRequestsPerDayPerProject): 30 richieste/giorno
Richieste di metadati delle istanze comuni impostate dal 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 per le metriche a livello di regione

Le seguenti quote si applicano ai metodi che utilizzano metriche regionali:

Gruppo di quote
Descrizione		 Nome metrica Quota predefinita
Quota per progetto per regione
Esegui query sulla
quota per i metodi regionali e zonali che creano, modificano o eliminano le risorse Compute Engine. Ad esempio, metodi instances.insert, disks.update e instances.delete.

I seguenti 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 Queries per minute per region: 1500
Richieste di lettura
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 Read requests per minute per region: 1500
Richieste di elenco
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 List requests per minute per region: 1500
Overhead dei costi per 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_regionBETA Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750.000 risorse escluse 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 effettui una query su questo limite di quota nella console Google Cloud.
Quota per le richieste di lettura delle operazioni
per i metodi regionOperations.get e zoneOperations.get.		 compute.googleapis.com/operation_read_requests_per_region Operation read requests per minute per region: 1500
Richieste di mutazione delle risorse globali per regione
Quota per metodi disks.createSnapshot, e regionDisks.createSnapshot.		 compute.googleapis.com/global_resource_write_requests_per_region GlobalResourceWriteRequestsPerMinutePerProjectPerRegion: 375
Richieste di output della porta seriale dell'istanza
Quota per il metodo instances.getSerialPortOutput.		 compute.googleapis.com/get_serial_port_output_requests_per_region GetSerialPortOutputRequestsPerMinutePerProjectPerRegion: 1500
Richieste di lettura pesanti
Quota per regionOperations.wait, zoneOperations.wait e regionNetworkFirewallPolicies.getEffectiveFirewalls metodi.		 compute.googleapis.com/heavy_weight_read_requests_per_region Heavyweight read requests per minute: 750
Richieste di mutazione pesante per regione
Quota per patch, metodi delete e insert per interconnectAttachments risorsa e per il metodo networks.updatePeering.		 compute.googleapis.com/heavy_weight_write_requests_per_region HeavyWeightWriteRequestsPerMinutePerProjectPerRegion: 750
Richieste di simulazione di eventi di manutenzione per istanza
Quota per il metodo instances.simulateMaintenanceEvent.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion: 150
Richieste di referrer dell'elenco di istanze
Quota per il metodo instances.listReferrers.		 compute.googleapis.com/instance_list_referrers_requests_per_region InstanceListReferrersRequestsPerMinutePerProjectPerRegion: 3000
Quota
per le richieste di scrittura degli endpoint di rete per i metodi networkEndpointGroups.attachNetworkEndpoints e networkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/network_endpoint_write_requests_per_region NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 1500
Richieste di elenco di endpoint di rete
Quota per metodo networkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/network_endpoint_list_requests_per_region NetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500
Richieste di scrittura endpoint di rete a livello di regione
Quota per regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 150
Richieste di elenco di endpoint di rete a livello di regione
Quota per il metodo regionNetworkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_list_requests_per_region RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500

Richiedi un aumento delle quote di frequenza

Se hai bisogno di una quota più alta per effettuare richieste API, puoi richiedere un aumento nella quota API dalla console Google Cloud. Per istruzioni, consulta Richiesta di una quota superiore.

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