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 Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote per la metrica |
compute.googleapis.com/filtered_list_cost_overheadFrequenza 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
|
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 |
|
| 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 Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote per la metrica |
compute.googleapis.com/filtered_list_cost_overhead_per_regionTariffa 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
|
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 HeavyWeightWriteRequestsPerMinutePerProjectPerRegionQuota 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 InstanceListReferrersRequestsPerMinutePerProjectPerRegionQuota per il metodo instances.listReferrers. |
compute.googleapis.com/instance_list_referrers_requests_per_region |
Richieste di scrittura di endpoint di rete NetworkEndpointWriteRequestsPerMinutePerProjectPerRegionQuota 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 Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote per le metriche |
compute.googleapis.com/filtered_list_cost_overhead_per_regionTariffa 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
- Scopri di più sul monitoraggio dell'utilizzo delle API.
- Scopri come configurare gli avvisi quota.