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 alla console Google Cloud, inviate richieste anche all'API e a questi 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 al 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 l'errore,
attendere un minuto, quindi riprovare a eseguire la richiesta: la quota dovrebbe essere ricaricata
l'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 separatamente per poter 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 specificato altrimenti:
Gruppo di quote Descrizione |
Nome metrica | Quota predefinita |
---|---|---|
Query Quota per i metodi di mutazione globali non inclusi in e le altre metriche delle quote. Anche i seguenti metodi
|
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 dell'operazione 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 Google Cloud addebita l'utilizzo della quota per questa metrica in aggiunta a
le quote
|
compute.googleapis.com/filtered_list_cost_overhead BETA |
Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProject ):
750.000 risorse filtrate/minuto
|
Richieste di mutazione delle risorse globali Quota per 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 di peso elevato Quota per 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 pesante 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 delle licenze Quote per il metodo licenses.insert . |
compute.googleapis.com/license_insert_requests |
|
Richieste comuni di metadati di istanze impostate dal progetto Quota per Metodo projects.setCommonInstanceMetadata . |
compute.googleapis.com/project_set_common_instance_metadata_requests |
Quota per progetto (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject ):
36 richieste al 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 |
---|---|---|
Quota per le query per i metodi regionali e di zona che creano, modificare o eliminare risorse Compute Engine. Ad esempio: instances.insert , disks.update e
instances.delete .
I seguenti
|
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
ad esempio 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 metodi list a livello di regione e zona
ad esempio 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 Google Cloud addebita l'utilizzo della quota per questa metrica in aggiunta a
le quote
|
compute.googleapis.com/filtered_list_cost_overhead_per_region BETA |
Tariffa per progetto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion ):
750.000 risorse filtrate/minuto
|
Richieste di lettura dell'operazione Quota per 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 disks.createSnapshot ,
e regionDisks.createSnapshot . |
compute.googleapis.com/global_resource_write_requests_per_region |
GlobalResourceWriteRequestsPerMinutePerProjectPerRegion : 375 |
Richieste di output della porta seriale per l'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 |
L'istanza simula le 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 metodo instances.listReferrers . |
compute.googleapis.com/instance_list_referrers_requests_per_region |
InstanceListReferrersRequestsPerMinutePerProjectPerRegion : 3000 |
Richieste di scrittura endpoint di rete Quota per 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 dell'API Compute Engine per quote di tariffa per la conservazione per mitigare gli effetti delle quote di frequenza.
Passaggi successivi
- Scopri di più sull'utilizzo dell'API Monitoring.
- Scopri come configurare avvisi sulle quote.