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 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 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 dai gruppi di quota, come descritto nelle tabelle seguenti. Ogni gruppo viene conteggiato singolarmente, 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 |
|---|---|---|
| Quota per le query relative ai metodi di mutazione globale non inclusi nelle altre metriche relative alle quote. Anche i seguenti metodi
|
compute.googleapis.com/default |
Quota per progetto (defaultPerMinutePerProject):
1500 richieste/minuto |
| Richieste di lettura Quota per i metodi *.get globali. |
compute.googleapis.com/read_requests |
Quota per progetto (ReadRequestsPerMinutePerProject):
1500 richieste/minuto |
| Elenca le richieste Quota per i metodi *.listglobali. |
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 |
| Costo di overhead dell'elenco filtrato Quota per metodi
Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote relative alle metriche |
compute.googleapis.com/filtered_list_cost_overhead |
Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProject):
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 effettui una query su questo limite di quota nella 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 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 le metriche regionali
Le seguenti quote si applicano ai metodi che utilizzano metriche a livello di regione:
| Gruppo di quote Descrizione |
Nome metrica | Quota predefinita Quota per progetto per regione |
|---|---|---|
| Esegui query sulla quota per i metodi a livello di regione e di zona che creano, modificano o eliminano le risorse Compute Engine. Ad esempio, metodi instances.insert, disks.update e instances.delete.
I seguenti metodi
|
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 |
| Costo di overhead dell'elenco filtrato Quota per metodi
Google Cloud addebita l'utilizzo della quota per questa metrica oltre alle quote relative alle metriche |
compute.googleapis.com/filtered_list_cost_overhead_per_regionBETA |
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 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 i metodi regionOperations.wait,
zoneOperations.wait e
regionNetworkFirewallPolicies.getEffectiveFirewalls. |
compute.googleapis.com/heavy_weight_read_requests_per_region |
Heavyweight read requests per minute: 750 |
| Richieste di mutazioni pesanti per regione 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 |
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 |
| Richieste di scrittura dell'endpoint di rete Quota per metodi networkEndpointGroups.attachNetworkEndpoints
e networkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/network_endpoint_write_requests_per_region |
NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 1500 |
| Richieste di elenchi di endpoint di rete Quota per il metodo networkEndpointGroups.listNetworkEndpoints. |
compute.googleapis.com/network_endpoint_list_requests_per_region |
NetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500 |
| Quota per le richieste di scrittura degli endpoint di rete regionali per i metodi regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints. |
compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 150 |
| Richieste di elenchi 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 |
Richiedere un aumento delle quote tariffarie
Se hai bisogno di una quota più alta per effettuare richieste API, puoi richiedere un aumento della quota API dalla console Google Cloud. Per le istruzioni, consulta Richiedere una quota più alta.
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
- Scopri di più sul monitoraggio dell'utilizzo delle API.
- Scopri come configurare gli avvisi sulla quota.