Quotas de taxa do Compute Engine

Este documento lista as quotas de taxa do Compute Engine, que definem o número de pedidos que pode fazer aos métodos da API Compute Engine.

Quotas de tarifas

As quotas de taxa (também conhecidas como limites de taxa da API ou quotas da API) definem o número de pedidos que podem ser feitos à API Compute Engine. Estas quotas aplicam-se por projeto. Cada quota aplica-se a um grupo de um ou mais métodos da API Compute Engine. Quando usa a CLI gcloud ou a consola, também está a fazer pedidos à API, e estes pedidos contam para a sua quota de taxa. Google Cloud Se usar contas de serviço para aceder à API, isso também conta para a sua quota de taxa.

A Google aplica quotas de taxa a um intervalo por minuto (60 segundos) para cada grupo. Isto significa que, se o seu projeto atingir o número máximo de pedidos API em qualquer altura no prazo de 60 segundos, tem de aguardar que essa quota de taxa seja reposta antes de fazer mais pedidos nesse grupo. Se o seu projeto exceder uma quota de taxa, recebe um erro 403 com o motivo rateLimitExceeded. Para resolver este erro, aguarde um minuto e, em seguida, tente novamente o seu pedido. A quota deve ser reposta no início do intervalo seguinte.

O número de pedidos que pode fazer à API Compute Engine é definido pelas quotas da API, conforme descrito nas tabelas seguintes. Cada grupo é contabilizado separadamente, pelo que pode atingir a quota máxima em cada grupo em simultâneo.

Quotas de tarifas para métodos globais

As secções seguintes listam as quotas que definem o número de pedidos que pode fazer aos métodos da API Compute Engine global.

Quotas da API simplificadas para métodos globais

Para melhorar a capacidade de deteção e gestão da quota da API Compute Engine, Google Cloud reduziu o número de métricas de quota consolidando as métricas em menos quotas. Estas métricas de quota simplificadas também oferecem limites mais elevados para cada quota.

Para ver uma lista completa de métodos globais e as métricas de quota que monitorizam o custo de cada método, consulte a referência das métricas de quota da API Compute Engine.

A tabela seguinte apresenta todas as métricas de quotas da API simplificadas para a API Compute Engine:

Quota
Descrição da quota		 Nome da métrica
Pedidos de leitura por minuto (GlobalReadsPerMinutePerProject)
Quota para métodos get e list globais. 		compute.googleapis.com/global_reads
Pedidos de escrita por minuto (GlobalWritesPerMinutePerProject)
Quota para métodos de escrita globais que não estão incluídos noutras métricas de quota. 		compute.googleapis.com/global_writes
Lista de pedidos utilizáveis por minuto (GlobalListUsablePerMinutePerProject)
Quota para métodos ListUsable globais. 		compute.googleapis.com/list_usable_requests
Pedidos de invalidação de cache por minuto (GlobalCacheInvalidationRequestsPerMinutePerProject)
Quota para métodos UrlMapsService.InvalidateCache globais. 		compute.googleapis.com/global_cache_invalidation_requests
Custos gerais da lista filtrada (ListRequestsFilterCostOverheadPerMinutePerProject)

Quota para *.list e *.aggregatedList métodos globais com filtros.

Google Cloud cobra a utilização da quota para esta métrica, além das quotas relativas à métrica compute.googleapis.com/global_reads. Incorre em custos de quota se existirem mais de 10 000 recursos filtrados dos pedidos de lista. A API Compute Engine rejeita os pedidos de lista se exceder este limite de quota.

 compute.googleapis.com/filtered_list_cost_overhead
Taxa por projeto: 750 mil recursos filtrados dos pedidos de lista por região por minuto. Uma vez que a quota é cobrada por cada 10 mil recursos, vê o limite como 75 (750 mil/10 mil) quando consulta este limite de quota na consola. Google Cloud
Pedidos por minuto (GlobalRequestsPerMinutePerProject)

Quota para todos os pedidos de leitura e escrita globais.

 compute.googleapis.com/global_requests

Quotas da API antiga para métodos globais

A tabela seguinte lista todas as quotas da API Compute Engine para métodos globais.

Quota
Descrição da quota		 Nome da métrica
Consultas por minuto (defaultPerMinutePerProject)
Quota para métodos de mutação e de listas globais que não estão incluídos noutras métricas de quota.

Os seguintes métodos get também usam esta métrica default:

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default
Pedidos de leitura (antigos) (ReadRequestsPerMinutePerProject)
Quota para métodos *.get globais.		 compute.googleapis.com/read_requests
Pedidos de lista (ListRequestsPerMinutePerProject)
Quota para métodos *.list globais.		 compute.googleapis.com/list_requests
Pedidos de leitura de operações (OperationReadRequestsPerMinutePerProject)
Quota para o método globalOperations.get.		 compute.googleapis.com/operation_read_requests
Pedidos de mutação de recursos globais (GlobalResourceWriteRequestsPerMinutePerProject)
Quota para os métodos 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
Pedidos de mutação pesados (HeavyWeightWriteRequestsPerMinutePerProject)
Quota para os métodos patch, delete e insert para os recursos interconnects.		 compute.googleapis.com/heavy_weight_write_requests
Pedidos de leitura pesados (HeavyWeightReadRequestsPerMinutePerProject)
Quota para métodos *.aggregatedList.		 compute.googleapis.com/heavy_weight_read_requests

As seguintes quotas aplicam-se às APIs globais com quotas por método:

Quota
Descrição da quota		 Nome da métrica Limite predefinido
Pedidos de inserção de licenças
Quotas para o método licenses.insert.		 compute.googleapis.com/license_insert_requests
  • Quota por projeto (LicenseInsertRequestsPerMinutePerProject): 2,5 pedidos/segundo (150 pedidos/minuto)
  • Quota por dia por projeto (LicenseInsertRequestsPerDayPerProject): 30 pedidos/dia
Quota de pedidos de metadados de instâncias comuns definidos pelo projeto para o método
projects.setCommonInstanceMetadata.		 compute.googleapis.com/project_set_common_instance_metadata_requests Quota por projeto (ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 36 pedidos/minuto

Limites de taxa para métodos regionais e zonais

As secções seguintes listam todas as quotas aplicáveis a métodos que usam métricas regionais.

Quotas da API simplificadas para métodos regionais e zonais

A tabela seguinte lista todas as quotas simplificadas para métodos regionais e zonais da API Compute Engine. Para ver uma lista completa de métodos regionais e zonais, e as métricas de quota que monitorizam a utilização de cada método, consulte a referência de métricas de quota da API Compute Engine.

Quota
Descrição da quota		 Nome da métrica
Pedidos de leitura por minuto por região (ReadRequestsPerMinutePerProjectPerRegion)
Quota para métodos `get` e `list` regionais e zonais.		 compute.googleapis.com/reads_per_region
Pedidos de escrita por região (WritesPerMinutePerProjectPerRegion)
Quota para métodos de escrita regionais e zonais que não estão incluídos noutras métricas de quota. 		compute.googleapis.com/writes_per_region
Lista de pedidos utilizáveis por região (ListUsablePerMinutePerProjectPerRegion)
Quota para métodos regionais e zonais ListUsable. 		compute.googleapis.com/list_usable_requests_per_region
Custos gerais da lista filtrada por região

Quota para métodos regionais e zonais de *.list e *.aggregatedList com filtros.

Google Cloud cobra a utilização da quota para esta métrica, além das quotas relativas à métrica compute.googleapis.com/reads_per_region. Incorre em custos de quota se existirem mais de 10 000 recursos filtrados dos pedidos de lista. A API Compute Engine rejeita os pedidos de lista se exceder este limite de quota.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
Tarifa por projeto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750 mil recursos filtrados dos pedidos de listas por região por minuto. Uma vez que a quota é cobrada por cada 10 mil recursos, vê o limite como 75 (750 mil/10 mil) quando consulta este limite de quota na consola. Google Cloud
Pedidos por minuto por região (RequestsPerMinutePerProjectPerRegion)

Quota para todos os pedidos de leitura e escrita regionais.

 compute.googleapis.com/requests_per_region

Quotas da API antiga para métodos regionais

A tabela seguinte apresenta todas as quotas da API Compute Engine para métodos regionais e zonais.

Quota
Descrição da quota		 Nome da métrica
Consultas (QueriesPerMinutePerRegion)
Quota para métodos regionais e zonais que criam, modificam ou eliminam recursos do Compute Engine. Por exemplo, instances.insert, disks.update e métodos instances.delete.

Os seguintes métodos get, list e patch também usam esta métrica 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
Pedidos de leitura (antigos) (ReadRequestsPerMinutePerRegion)
Quota para métodos get regionais e zonais como autoscalers.get, disks.get, instances.get e machineTypes.get.		 compute.googleapis.com/read_requests_per_region
Pedidos de listas (ListRequestsPerMinutePerRegion)
Quota para métodos regionais e zonais list como autoscalers.list, disks.list, instances.list> e machineTypes.list.		 compute.googleapis.com/list_requests_per_region
Sobrecarga do custo da lista filtrada

Quota para os métodos *.list e *.aggregatedList com filtros.

Google Cloud cobra a utilização da quota para esta métrica, além das quotas relativas às métricas compute.googleapis.com/list_requests_per_region e compute.googleapis.com/heavy_weight_read_requests_per_region. Incorre em custos de quota se existirem mais de 10 000 recursos filtrados dos pedidos de lista. A API Compute Engine rejeita os pedidos de lista se exceder este limite de quota.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
Tarifa por projeto (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 750 mil recursos filtrados dos pedidos de lista por região por minuto. Uma vez que a quota é cobrada por cada 10 mil recursos, vê o limite como 75 (750 mil/10 mil) quando consulta este limite de quota na consola. Google Cloud
Pedidos de leitura de operações (OperationReadRequestsPerMinutePerRegion)
Quota para os métodos regionOperations.get e zoneOperations.get.		 compute.googleapis.com/operation_read_requests_per_region
Pedidos de mutação de recursos globais por região (GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
Quota para os métodos disks.createSnapshot, e regionDisks.createSnapshot.		 compute.googleapis.com/global_resource_write_requests_per_region
Pedidos de saída da porta de série de obtenção de instâncias (GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)
Quota para o método instances.getSerialPortOutput.		 compute.googleapis.com/get_serial_port_output_requests_per_region
Pedidos de leitura com peso elevado (HeavyWeightReadRequestsPerMinutePerRegion)
Quota para os métodos regionOperations.wait, zoneOperations.wait e regionNetworkFirewallPolicies.getEffectiveFirewalls.		 compute.googleapis.com/heavy_weight_read_requests_per_region
Pedidos de mutação com peso elevado por região HeavyWeightWriteRequestsPerMinutePerProjectPerRegion
Quota para os métodos patch, delete e insert para o recurso interconnectAttachments e para o método networks.updatePeering.		 compute.googleapis.com/heavy_weight_write_requests_per_region
Pedidos de eventos de manutenção de simulação de instâncias (SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
Quota para o método instances.simulateMaintenanceEvent.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region
Pedidos de referenciadores da lista de instâncias InstanceListReferrersRequestsPerMinutePerProjectPerRegion
Quota para o método instances.listReferrers.		 compute.googleapis.com/instance_list_referrers_requests_per_region
Pedidos de gravação de pontos finais de rede NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
Quota para networkEndpointGroups.attachNetworkEndpoints e métodos networkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/network_endpoint_write_requests_per_region
Pedidos de lista de pontos finais da rede (NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota para o método networkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/network_endpoint_list_requests_per_region
Pedidos de escrita de pontos finais de rede regionais (RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
Quota para os métodos regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region
Pedidos de lista de pontos finais de rede regionais (RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
Quota para o método regionNetworkEndpointGroups.listNetworkEndpoints.		 compute.googleapis.com/regional_network_endpoint_list_requests_per_region

Peça um aumento das quotas de taxa

Se precisar de uma quota mais elevada para fazer pedidos à API, pode pedir um aumento da quota da API na Google Cloud consola. Para obter instruções, consulte o artigo Peça um ajuste da quota.

Práticas recomendadas

Siga as práticas recomendadas da API Compute Engine para preservar as quotas de taxa para mitigar os efeitos das quotas de taxa.

O que se segue?