Questo documento elenca le quote di frequenza di Compute Engine, che definiscono il numero di richieste 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 di richieste che possono essere inviate 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 Google Cloud, invii anche richieste all'API e queste vengono conteggiate ai fini della quota di frequenza. Anche l'utilizzo di account di servizio per accedere all'API è incluso nel calcolo della quota di frequenza.
Google applica le quote di frequenza a intervalli al 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 frequenza venga ricaricata prima di effettuare altre richieste in quel gruppo. Se il progetto supera una quota di frequenza, viene visualizzato un errore 403 con motivo rateLimitExceeded
. Per risolvere questo errore, attendi un minuto, quindi riprova a eseguire la richiesta. La quota dovrebbe essere ricaricata all'inizio dell'intervallo successivo.
Il numero di richieste che puoi inviare all'API Compute Engine è definito dai gruppi di quote, come descritto nelle tabelle seguenti. Ogni gruppo viene conteggiato separatamente, in modo da poter raggiungere la quota massima in ogni gruppo contemporaneamente.
Quote di frequenza per le metriche globali
I seguenti gruppi di quota 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. Anche i seguenti metodi
|
compute.googleapis.com/default |
Quota per progetto (defaultPerMinutePerProject ):
1500 richieste al minuto |
Richieste di lettura Quota per i metodi *.get globali. |
compute.googleapis.com/read_requests |
Quota per progetto (ReadRequestsPerMinutePerProject ):
1500 richieste al minuto |
Richieste di elenco Quota per i metodi *.list globali. |
compute.googleapis.com/list_requests |
Quota per progetto (ListRequestsPerMinutePerProject ):
1500 richieste al minuto |
Richieste di lettura dell'operazione Quota per il metodo globalOperations.get . |
compute.googleapis.com/operation_read_requests |
Tariffa per progetto (OperationReadRequestsPerMinutePerProject ):
1500 richieste al minuto |
Costo complessivo dei costi per elenco filtrato Quota per
Per questa metrica, Google Cloud addebita l'utilizzo della quota,
oltre alle quote,
sulle metriche |
compute.googleapis.com/filtered_list_cost_overhead BETA |
Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProject ):
750.000 risorse filtrate al minuto
|
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 al minuto |
Richieste di mutazione pesante 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 al minuto |
Richieste di lettura con volumi elevati Quota per *.aggregatedList metodi. |
compute.googleapis.com/heavy_weight_read_requests |
Tariffa per progetto (HeavyWeightReadRequestsPerMinutePerProject ):
750 richieste al 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 licenza Quote per metodo licenses.insert . |
compute.googleapis.com/license_insert_requests |
|
Richieste comuni di metadati di istanze impostate di 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 frequenza per metriche regionali
Le seguenti quote si applicano ai metodi che utilizzano metriche regionali:
Gruppo di quote Descrizione |
Nome metrica | Quota predefinita Quota per progetto per regione |
---|---|---|
Quota per le query per i metodi a livello di regione e zona che creano, modificano o eliminano risorse Compute Engine. Ad esempio, i metodi instances.insert , disks.update e
instances.delete .
Anche i seguenti metodi
|
compute.googleapis.com/default_per_region |
Queries per minute per region : 1500 |
Richieste di lettura Quota per metodi get a livello di regione e zona
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 a livello di regione e zona
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 complessivo dei costi per elenco filtrato Quota per
Per questa metrica, Google Cloud addebita l'utilizzo della quota,
oltre alle quote,
sulle metriche |
compute.googleapis.com/filtered_list_cost_overhead_per_region BETA |
Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion ):
750.000 risorse filtrate al minuto
|
Richieste di lettura dell'operazione Quota 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 i metodi disks.createSnapshot e regionDisks.createSnapshot . |
compute.googleapis.com/global_resource_write_requests_per_region |
GlobalResourceWriteRequestsPerMinutePerProjectPerRegion : 375 |
L'istanza riceve le richieste di output della porta seriale Quota per il metodo instances.getSerialPortOutput . |
compute.googleapis.com/get_serial_port_output_requests_per_region |
GetSerialPortOutputRequestsPerMinutePerProjectPerRegion : 1500 |
Richieste di lettura con peso elevato 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 mutazione con peso elevato 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 |
L'istanza simula richieste di eventi di manutenzione Quota per il metodo instances.simulateMaintenanceEvent . |
compute.googleapis.com/simulate_maintenance_event_requests_per_region |
SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion : 150 |
Richieste referrer elenco istanze Quota per il metodo instances.listReferrers . |
compute.googleapis.com/instance_list_referrers_requests_per_region |
InstanceListReferrersRequestsPerMinutePerProjectPerRegion : 3000 |
Richieste di scrittura endpoint di rete Quota 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 il 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 i metodi regionNetworkEndpointGroups.attachNetworkEndpoints
e regionNetworkEndpointGroups.detachNetworkEndpoints . |
compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion : 150 |
Richieste di elenco di endpoint di rete regionali 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 della quota API dalla console Google Cloud. Per le istruzioni, consulta Richiesta di una quota maggiore.
best practice
Segui le best practice dell'API Compute Engine per conservare le quote di frequenza e mitigare gli effetti delle quote di frequenza.
Passaggi successivi
- Scopri di più sull'utilizzo dell'API Monitoring.
- Scopri come configurare avvisi sulla quota.