Este documento lista as cotas de taxa do Compute Engine, que definem o número de solicitações que você pode fazer aos métodos da API do Compute Engine.
Cotas tarifárias
As cotas de taxa (também conhecidas como limites de taxa de API ou cotas de API) definem o número de solicitações que podem ser feitas à API Compute Engine . Essas cotas são aplicadas por projeto. Cada cota se aplica a um grupo de um ou mais métodos da API Compute Engine. Ao usar a CLI gcloud ou o console do Google Cloud, você também faz solicitações à API, e essas solicitações são contabilizadas na sua cota de taxa. Se você usa contas de serviço para acessar a API, isso também conta para sua cota tarifária.
O Google impõe cotas de taxas em intervalos de um minuto (60 segundos) para cada grupo. Isso significa que se o seu projeto atingir o número máximo de solicitações de API a qualquer momento em 60 segundos, você deverá aguardar que essa cota de taxa seja preenchida antes de fazer mais solicitações nesse grupo. Se o seu projeto exceder uma cota de taxa, você receberá um erro 403 com o motivo rateLimitExceeded . Para resolver esse erro, aguarde um minuto e tente fazer a solicitação novamente. A cota deverá ser recarregada no início do próximo intervalo.
O número de solicitações que você pode fazer à API Compute Engine é definido pelas cotas da API, conforme descrito nas tabelas a seguir. Cada grupo é contado separadamente, para que você possa atingir a cota máxima em cada grupo simultaneamente.
Cotas tarifárias para métodos globais
As seções a seguir listam as cotas que definem o número de solicitações que você pode fazer aos métodos globais da API Compute Engine.
Cotas de API simplificadas para métodos globais
Para melhorar a descoberta e o gerenciamento da cota da API Compute Engine,Google Cloud reduziu o número de métricas de cota consolidando métricas em menos cotas. Estas métricas de cota simplificadas também oferecem limites mais elevados para cada cota.
Para ver uma lista completa de métodos globais e as métricas de cota que rastreiam o custo de cada método, consulte Referência de métricas de cota da API Compute Engine .
A tabela a seguir lista todas as métricas de cota de API simplificadas para a API Compute Engine:
| Contingente Descrição da cota | Nome da métrica |
|---|---|
Solicitações de leitura por minuto ( GlobalReadsPerMinutePerProject )Cota para métodos globais get e list . | compute.googleapis.com/global_reads |
Solicitações de mutação por minuto ( GlobalWritesPerMinutePerProject )Cota para métodos de gravação globais que não estão incluídos em outras métricas de cota. | compute.googleapis.com/global_writes |
Listar solicitações utilizáveis por minuto ( GlobalListUsablePerMinutePerProject )Cota para métodos ListUsable globais. | compute.googleapis.com/list_usable_requests |
Solicitações de invalidação de cache por minuto ( GlobalCacheInvalidationRequestsPerMinutePerProject )Cota para métodos UrlMapsService.InvalidateCache globais. | compute.googleapis.com/global_cache_invalidation_requests |
Custo indireto de lista filtrada ( ListRequestsFilterCostOverheadPerMinutePerProject ) Cota para métodos globais Google Cloud cobra o uso da cota para essa métrica, além das cotas da métrica | compute.googleapis.com/filtered_list_cost_overheadTaxa por projeto: 750 mil recursos filtrados da lista de solicitações por região por minuto. Como a cota é cobrada para cada 10 mil recursos, você vê o limite como 75 (750 mil/10 mil) ao consultar esse limite de cota no console do Google Cloud. |
Solicitações por minuto ( GlobalRequestsPerMinutePerProject )Cota para todas as solicitações globais de leitura e gravação. | compute.googleapis.com/global_requests |
Cotas de API legadas para métodos globais
A tabela a seguir lista todas as cotas da API Compute Engine para métodos globais.
| Contingente Descrição da cota | Nome da métrica |
|---|---|
Consultas por minuto ( defaultPerMinutePerProject )Cota para lista global e métodos de mutação que não estão incluídos em outras métricas de cota. Os métodos
| compute.googleapis.com/default |
Solicitações de leitura ( ReadRequestsPerMinutePerProject )para métodos *.get globais. | compute.googleapis.com/read_requests |
Listar solicitações ( ListRequestsPerMinutePerProject )Cota para métodos *.list globais. | compute.googleapis.com/list_requests |
Solicitações de leitura de operação ( OperationReadRequestsPerMinutePerProject )Cota para o método globalOperations.get . | compute.googleapis.com/operation_read_requests |
Solicitações de mutação de recursos globais ( GlobalResourceWriteRequestsPerMinutePerProject )Cota para 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 |
Solicitações de mutação pesadas ( HeavyWeightWriteRequestsPerMinutePerProject )Cota para métodos patch , delete e insert para os recursos de interconnects . | compute.googleapis.com/heavy_weight_write_requests |
Solicitações de leitura pesadas ( HeavyWeightReadRequestsPerMinutePerProject )Cota para métodos *.aggregatedList . | compute.googleapis.com/heavy_weight_read_requests |
As cotas a seguir se aplicam a APIs globais com cotas por método:
| Contingente Descrição da cota | Nome da métrica | Limite padrão |
|---|---|---|
| Solicitações de inserção de licença Cotas para o método licenses.insert . | compute.googleapis.com/license_insert_requests |
|
| Projeto define solicitações de metadados de instância comuns Cota para o método projects.setCommonInstanceMetadata . | compute.googleapis.com/project_set_common_instance_metadata_requests | Cota por projeto ( ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject ): 36 solicitações/minuto |
Cotas tarifárias para métodos regionais e zonais
As seções a seguir listam todas as cotas que se aplicam a métodos que usam métricas regionais.
Cotas de API simplificadas para métodos regionais e zonais
A tabela a seguir lista todas as cotas 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 cota que rastreiam o uso de cada método, consulte Referência de métricas de cota da API Compute Engine .
| Contingente Descrição da cota | Nome da métrica |
|---|---|
Solicitações de leitura por minuto por região ( ReadRequestsPerMinutePerProjectPerRegion )Cota para métodos `get` e `list` regionais e zonais. | compute.googleapis.com/reads_per_region |
Solicitações de mutação ( WritesPerMinutePerProjectPerRegion )Cota para métodos de gravação regionais e zonais que não estão incluídos em outras métricas de cota. | compute.googleapis.com/writes_per_region |
Listar solicitações utilizáveis por região ( ListUsablePerMinutePerProjectPerRegion )Cota para métodos ListUsable regionais e zonais. | compute.googleapis.com/list_usable_requests_per_region |
| Custo indireto da lista filtrada por região Cota para métodos regionais e zonais Google Cloud cobra o uso da cota para essa métrica, além das cotas da métrica | compute.googleapis.com/filtered_list_cost_overhead_per_regionTaxa por projeto ( ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion ): 750 mil recursos filtrados das solicitações de lista por região por minuto. Como a cota é cobrada para cada 10 mil recursos, você vê o limite como 75 (750 mil/10 mil) ao consultar esse limite de cota no console do Google Cloud. |
Solicitações por minuto por região ( RequestsPerMinutePerProjectPerRegion )Cota para todas as solicitações regionais de leitura e gravação. | compute.googleapis.com/requests_per_region |
Cotas de API legadas para métodos regionais
A tabela a seguir lista todas as cotas da API Compute Engine para métodos regionais e zonais.
| Contingente Descrição da cota | Nome da métrica |
|---|---|
QueriesPerMinutePerRegionCota para métodos regionais e zonais que criam, modificam ou excluem recursos do Compute Engine. Por exemplo, métodos instances.insert , disks.update e instances.delete . Os seguintes métodos
| compute.googleapis.com/default_per_region |
Solicitações de leitura ReadRequestsPerMinutePerRegionCota para métodos get regionais e zonais, como autoscalers.get , disks.get , instances.get e machineTypes.get . | compute.googleapis.com/read_requests_per_region |
Listar solicitações ListRequestsPerMinutePerRegionCota para métodos list regional e zonal, como autoscalers.list , disks.list , instances.list e machineTypes.list . | compute.googleapis.com/list_requests_per_region |
| Custo indireto da lista filtrada Cota para métodos Google Cloud cobra o uso da cota para essa métrica, além das cotas das métricas | compute.googleapis.com/filtered_list_cost_overhead_per_regionTaxa por projeto ( ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion ): 750 mil recursos filtrados das solicitações de lista por região por minuto. Como a cota é cobrada para cada 10 mil recursos, você vê o limite como 75 (750 mil/10 mil) ao consultar esse limite de cota no console do Google Cloud. |
Solicitações de leitura de operação ( OperationReadRequestsPerMinutePerRegion )Cota para métodos regionOperations.get e zoneOperations.get . | compute.googleapis.com/operation_read_requests_per_region |
Solicitações de mutação de recursos globais por região ( GlobalResourceWriteRequestsPerMinutePerProjectPerRegion )Cota para métodos disks.createSnapshot e regionDisks.createSnapshot . | compute.googleapis.com/global_resource_write_requests_per_region |
Instância obtém solicitações de saída de porta serial ( GetSerialPortOutputRequestsPerMinutePerProjectPerRegion )Cota para o método instances.getSerialPortOutput . | compute.googleapis.com/get_serial_port_output_requests_per_region |
Solicitações de leitura pesadas ( HeavyWeightReadRequestsPerMinutePerRegion )Cota para os métodos regionOperations.wait , zoneOperations.wait e regionNetworkFirewallPolicies.getEffectiveFirewalls . | compute.googleapis.com/heavy_weight_read_requests_per_region |
Solicitações de mutação pesadas por região HeavyWeightWriteRequestsPerMinutePerProjectPerRegionCota para 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 |
Instância simula solicitações de eventos de manutenção ( SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion )Cota para o método instances.simulateMaintenanceEvent . | compute.googleapis.com/simulate_maintenance_event_requests_per_region |
Solicitações de referenciador de lista de instâncias InstanceListReferrersRequestsPerMinutePerProjectPerRegionCota para o método instances.listReferrers . | compute.googleapis.com/instance_list_referrers_requests_per_region |
Solicitações de gravação de endpoint de rede NetworkEndpointWriteRequestsPerMinutePerProjectPerRegionCota para métodos networkEndpointGroups.attachNetworkEndpoints e networkEndpointGroups.detachNetworkEndpoints . | compute.googleapis.com/network_endpoint_write_requests_per_region |
Solicitações de lista de endpoints de rede ( NetworkEndpointListRequestsPerMinutePerProjectPerRegion )Cota para o método networkEndpointGroups.listNetworkEndpoints . | compute.googleapis.com/network_endpoint_list_requests_per_region |
Solicitações de gravação de endpoint de rede regional ( RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion )Cota para os métodos regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints . | compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
Solicitações de lista de endpoints de rede regional ( RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion )Cota para o método regionNetworkEndpointGroups.listNetworkEndpoints . | compute.googleapis.com/regional_network_endpoint_list_requests_per_region |
Solicitar um aumento nas cotas tarifárias
Se precisar de uma cota maior para fazer solicitações de API, você poderá solicitar um aumento na cota de API no console do Google Cloud. Para obter instruções, consulte Solicitar uma cota mais alta .
Melhores práticas
Siga as práticas recomendadas da API Compute Engine para preservar as cotas tarifárias e mitigar os efeitos das cotas tarifárias.
O que vem a seguir
- Saiba mais sobre o uso da API de monitoramento .
- Saiba como configurar alertas de cota .
Este documento lista as cotas de taxa do Compute Engine, que definem o número de solicitações que você pode fazer aos métodos da API do Compute Engine.
Cotas tarifárias
As cotas de taxa (também conhecidas como limites de taxa de API ou cotas de API) definem o número de solicitações que podem ser feitas à API Compute Engine . Essas cotas são aplicadas por projeto. Cada cota se aplica a um grupo de um ou mais métodos da API Compute Engine. Ao usar a CLI gcloud ou o console do Google Cloud, você também faz solicitações à API, e essas solicitações são contabilizadas na sua cota de taxa. Se você usa contas de serviço para acessar a API, isso também conta para sua cota tarifária.
O Google impõe cotas de taxas em intervalos de um minuto (60 segundos) para cada grupo. Isso significa que se o seu projeto atingir o número máximo de solicitações de API a qualquer momento em 60 segundos, você deverá aguardar que essa cota de taxa seja preenchida antes de fazer mais solicitações nesse grupo. Se o seu projeto exceder uma cota de taxa, você receberá um erro 403 com o motivo rateLimitExceeded . Para resolver esse erro, aguarde um minuto e tente fazer a solicitação novamente. A cota deverá ser recarregada no início do próximo intervalo.
O número de solicitações que você pode fazer à API Compute Engine é definido pelas cotas da API, conforme descrito nas tabelas a seguir. Cada grupo é contado separadamente, para que você possa atingir a cota máxima em cada grupo simultaneamente.
Cotas tarifárias para métodos globais
As seções a seguir listam as cotas que definem o número de solicitações que você pode fazer aos métodos globais da API Compute Engine.
Cotas de API simplificadas para métodos globais
Para melhorar a descoberta e o gerenciamento da cota da API Compute Engine,Google Cloud reduziu o número de métricas de cota consolidando métricas em menos cotas. Estas métricas de cota simplificadas também oferecem limites mais elevados para cada cota.
Para ver uma lista completa de métodos globais e as métricas de cota que rastreiam o custo de cada método, consulte Referência de métricas de cota da API Compute Engine .
A tabela a seguir lista todas as métricas de cota de API simplificadas para a API Compute Engine:
| Contingente Descrição da cota | Nome da métrica |
|---|---|
Solicitações de leitura por minuto ( GlobalReadsPerMinutePerProject )Cota para métodos globais get e list . | compute.googleapis.com/global_reads |
Solicitações de mutação por minuto ( GlobalWritesPerMinutePerProject )Cota para métodos de gravação globais que não estão incluídos em outras métricas de cota. | compute.googleapis.com/global_writes |
Listar solicitações utilizáveis por minuto ( GlobalListUsablePerMinutePerProject )Cota para métodos ListUsable globais. | compute.googleapis.com/list_usable_requests |
Solicitações de invalidação de cache por minuto ( GlobalCacheInvalidationRequestsPerMinutePerProject )Cota para métodos UrlMapsService.InvalidateCache globais. | compute.googleapis.com/global_cache_invalidation_requests |
Custo indireto de lista filtrada ( ListRequestsFilterCostOverheadPerMinutePerProject ) Cota para métodos globais Google Cloud cobra o uso da cota para essa métrica, além das cotas da métrica | compute.googleapis.com/filtered_list_cost_overheadTaxa por projeto: 750 mil recursos filtrados da lista de solicitações por região por minuto. Como a cota é cobrada para cada 10 mil recursos, você vê o limite como 75 (750 mil/10 mil) ao consultar esse limite de cota no console do Google Cloud. |
Solicitações por minuto ( GlobalRequestsPerMinutePerProject )Cota para todas as solicitações globais de leitura e gravação. | compute.googleapis.com/global_requests |
Cotas de API legadas para métodos globais
A tabela a seguir lista todas as cotas da API Compute Engine para métodos globais.
| Contingente Descrição da cota | Nome da métrica |
|---|---|
Consultas por minuto ( defaultPerMinutePerProject )Cota para lista global e métodos de mutação que não estão incluídos em outras métricas de cota. Os métodos
| compute.googleapis.com/default |
Solicitações de leitura ( ReadRequestsPerMinutePerProject )para métodos *.get globais. | compute.googleapis.com/read_requests |
Listar solicitações ( ListRequestsPerMinutePerProject )Cota para métodos *.list globais. | compute.googleapis.com/list_requests |
Solicitações de leitura de operação ( OperationReadRequestsPerMinutePerProject )Cota para o método globalOperations.get . | compute.googleapis.com/operation_read_requests |
Solicitações de mutação de recursos globais ( GlobalResourceWriteRequestsPerMinutePerProject )Cota para 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 |
Solicitações de mutação pesadas ( HeavyWeightWriteRequestsPerMinutePerProject )Cota para métodos patch , delete e insert para os recursos de interconnects . | compute.googleapis.com/heavy_weight_write_requests |
Solicitações de leitura pesadas ( HeavyWeightReadRequestsPerMinutePerProject )Cota para métodos *.aggregatedList . | compute.googleapis.com/heavy_weight_read_requests |
As cotas a seguir se aplicam a APIs globais com cotas por método:
| Contingente Descrição da cota | Nome da métrica | Limite padrão |
|---|---|---|
| Solicitações de inserção de licença Cotas para o método licenses.insert . | compute.googleapis.com/license_insert_requests |
|
| Projeto define solicitações de metadados de instância comuns Cota para o método projects.setCommonInstanceMetadata . | compute.googleapis.com/project_set_common_instance_metadata_requests | Cota por projeto ( ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject ): 36 solicitações/minuto |
Cotas tarifárias para métodos regionais e zonais
As seções a seguir listam todas as cotas que se aplicam a métodos que usam métricas regionais.
Cotas de API simplificadas para métodos regionais e zonais
A tabela a seguir lista todas as cotas 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 cota que rastreiam o uso de cada método, consulte Referência de métricas de cota da API Compute Engine .
| Contingente Descrição da cota | Nome da métrica |
|---|---|
Solicitações de leitura por minuto por região ( ReadRequestsPerMinutePerProjectPerRegion )Cota para métodos `get` e `list` regionais e zonais. | compute.googleapis.com/reads_per_region |
Solicitações de mutação ( WritesPerMinutePerProjectPerRegion )Cota para métodos de gravação regionais e zonais que não estão incluídos em outras métricas de cota. | compute.googleapis.com/writes_per_region |
Listar solicitações utilizáveis por região ( ListUsablePerMinutePerProjectPerRegion )Cota para métodos ListUsable regionais e zonais. | compute.googleapis.com/list_usable_requests_per_region |
| Custo indireto da lista filtrada por região Cota para métodos regionais e zonais Google Cloud cobra o uso da cota para essa métrica, além das cotas da métrica | compute.googleapis.com/filtered_list_cost_overhead_per_regionTaxa por projeto ( ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion ): 750 mil recursos filtrados das solicitações de lista por região por minuto. Como a cota é cobrada para cada 10 mil recursos, você vê o limite como 75 (750 mil/10 mil) ao consultar esse limite de cota no console do Google Cloud. |
Solicitações por minuto por região ( RequestsPerMinutePerProjectPerRegion )Cota para todas as solicitações regionais de leitura e gravação. | compute.googleapis.com/requests_per_region |
Cotas de API legadas para métodos regionais
A tabela a seguir lista todas as cotas da API Compute Engine para métodos regionais e zonais.
| Contingente Descrição da cota | Nome da métrica |
|---|---|
QueriesPerMinutePerRegionCota para métodos regionais e zonais que criam, modificam ou excluem recursos do Compute Engine. Por exemplo, métodos instances.insert , disks.update e instances.delete . Os seguintes métodos
| compute.googleapis.com/default_per_region |
Solicitações de leitura ReadRequestsPerMinutePerRegionCota para métodos get regionais e zonais, como autoscalers.get , disks.get , instances.get e machineTypes.get . | compute.googleapis.com/read_requests_per_region |
Listar solicitações ListRequestsPerMinutePerRegionCota para métodos list regional e zonal, como autoscalers.list , disks.list , instances.list e machineTypes.list . | compute.googleapis.com/list_requests_per_region |
| Custo indireto da lista filtrada Cota para métodos Google Cloud cobra o uso da cota para essa métrica, além das cotas das métricas | compute.googleapis.com/filtered_list_cost_overhead_per_regionTaxa por projeto ( ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion ): 750 mil recursos filtrados das solicitações de lista por região por minuto. Como a cota é cobrada para cada 10 mil recursos, você vê o limite como 75 (750 mil/10 mil) ao consultar esse limite de cota no console do Google Cloud. |
Solicitações de leitura de operação ( OperationReadRequestsPerMinutePerRegion )Cota para métodos regionOperations.get e zoneOperations.get . | compute.googleapis.com/operation_read_requests_per_region |
Solicitações de mutação de recursos globais por região ( GlobalResourceWriteRequestsPerMinutePerProjectPerRegion )Cota para métodos disks.createSnapshot e regionDisks.createSnapshot . | compute.googleapis.com/global_resource_write_requests_per_region |
Instância obtém solicitações de saída de porta serial ( GetSerialPortOutputRequestsPerMinutePerProjectPerRegion )Cota para o método instances.getSerialPortOutput . | compute.googleapis.com/get_serial_port_output_requests_per_region |
Solicitações de leitura pesadas ( HeavyWeightReadRequestsPerMinutePerRegion )Cota para os métodos regionOperations.wait , zoneOperations.wait e regionNetworkFirewallPolicies.getEffectiveFirewalls . | compute.googleapis.com/heavy_weight_read_requests_per_region |
Solicitações de mutação pesadas por região HeavyWeightWriteRequestsPerMinutePerProjectPerRegionCota para 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 |
Instância simula solicitações de eventos de manutenção ( SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion )Cota para o método instances.simulateMaintenanceEvent . | compute.googleapis.com/simulate_maintenance_event_requests_per_region |
Solicitações de referenciador de lista de instâncias InstanceListReferrersRequestsPerMinutePerProjectPerRegionCota para o método instances.listReferrers . | compute.googleapis.com/instance_list_referrers_requests_per_region |
Solicitações de gravação de endpoint de rede NetworkEndpointWriteRequestsPerMinutePerProjectPerRegionCota para métodos networkEndpointGroups.attachNetworkEndpoints e networkEndpointGroups.detachNetworkEndpoints . | compute.googleapis.com/network_endpoint_write_requests_per_region |
Solicitações de lista de endpoints de rede ( NetworkEndpointListRequestsPerMinutePerProjectPerRegion )Cota para o método networkEndpointGroups.listNetworkEndpoints . | compute.googleapis.com/network_endpoint_list_requests_per_region |
Solicitações de gravação de endpoint de rede regional ( RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion )Cota para os métodos regionNetworkEndpointGroups.attachNetworkEndpoints e regionNetworkEndpointGroups.detachNetworkEndpoints . | compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
Solicitações de lista de endpoints de rede regional ( RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion )Cota para o método regionNetworkEndpointGroups.listNetworkEndpoints . | compute.googleapis.com/regional_network_endpoint_list_requests_per_region |
Solicitar um aumento nas cotas tarifárias
Se precisar de uma cota maior para fazer solicitações de API, você poderá solicitar um aumento na cota de API no console do Google Cloud. Para obter instruções, consulte Solicitar uma cota mais alta .
Melhores práticas
Siga as práticas recomendadas da API Compute Engine para preservar as cotas tarifárias e mitigar os efeitos das cotas tarifárias.
O que vem a seguir
- Saiba mais sobre o uso da API de monitoramento .
- Saiba como configurar alertas de cota .