Quotas de operações simultâneas do Compute Engine

---

Este documento descreve as quotas de funcionamento concorrente do Compute Engine.

Quotas de operações simultâneas

As quotas de operações simultâneas definem o número de operações em curso ou simultâneas que podem ocorrer em qualquer momento. Qualquer pedido de API que crie, modifique ou elimine um recurso do Compute Engine está sujeito a uma verificação do limite de operações simultâneas para garantir que o número total de operações em curso em qualquer momento não excede o limite especificado para essa operação.

Erro de limite de operações em simultâneo excedido

Se o seu projeto exceder o limite de operações simultâneas para qualquer operação em curso, recebe um erro 403 com o motivo rateLimitExceeded.

A resposta da API do erro é semelhante à seguinte:

    "error": {
      "code": 403,
      "message": "Rate Limit Exceeded",
      "errors": [
        {
          "message": "Rate Limit Exceeded",
          "domain": "usageLimits",
          "reason": "rateLimitExceeded",
        ...
        ...
        }
      ],
      "details": [
        {
          "@type": "type.googleapis.com/google.rpc.ErrorInfo",
          "reason": "CONCURRENT_OPERATIONS_QUOTA_EXCEEDED",
          "domain": "compute.googleapis.com",
          "metadata": {
            "containerType": "PROJECT",
            "containerId": "PROJECT_ID",
            "quotaMetric": "QUOTA_METRIC",
            "quotaLimit": "QUOTA_LIMIT",
            "operationType": "OPERATION_TYPE",
            "location": "global | REGION"
          }
        },
        {
          "@type": "type.googleapis.com/google.rpc.Help",
          "links": [
            {
              "description": "Concurrent operations quota documentation.",
              "url": "https://cloud.google.com/compute/operations-quota#concurrent_operation_limits"
            }
          ]
        },
      ...
      ... 

Os detalhes do erro contêm os seguintes valores:

• PROJECT_ID: o ID do projeto no qual a quota excede o limite.

• QUOTA_METRIC: a métrica para a quota concorrente que excede o limite. Pode ser uma das seguintes:

  • compute.googleapis.com/global_concurrent_operations
  • compute.googleapis.com/regional_concurrent_operations

• QUOTA_LIMIT: o nome do limite da quota simultânea. Pode ser uma das seguintes:

  • GlobalConcurrentOperationsPerProject
  • GlobalConcurrentOperationsPerProjectOperationType
  • RegionalConcurrentOperationsPerProject
  • RegionalConcurrentOperationsPerProjectOperationType

• OPERATION_TYPE: a operação global ou regional para a qual a quota excede o limite. Para ver uma lista de operações, consulte o artigo Grupos de quotas de operações simultâneas.

• O location pode ser um dos seguintes:

  • global: especifica que o limite foi excedido para a quota de operações global
  • REGION: especifica a região onde o limite foi excedido para a quota de operações

Os registos de erros detalhados são devolvidos apenas através da resposta da API. O erro no Explorador de registos é semelhante ao seguinte:

   "protoPayload":{
    "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
    "status": {
      "message": "Rate Limit Exceeded"
    }
    "serviceName": "compute.googleapis.com",
    "methodName": "METHOD_NAME",
    ...
    ...
    "response": {
      "error": {
        "message": "Rate Limit Exceeded",
        "code": 403,
        "errors": [
          {
            "message": "Rate Limit Exceeded",
            "reason": "rateLimitExceeded",
            "domain": "usageLimits"
          }
        ]
      },
      "@type": "type.googleapis.com/error"
    },
    ...
    ... 

O METHOD_NAME no erro representa o método da API para o qual o limite de velocidade foi excedido. Por exemplo, v1.compute.instances.stop.

Grupos de quotas de operações simultâneas

Esta secção descreve os limites para várias operações em curso ou simultâneas do Compute Engine.

Quotas de operações globais

As operações globais simultâneas consomem um limite global especificado para os tipos de operações por projeto. A tabela seguinte apresenta as quotas globais para operações em curso e as métricas correspondentes.

Pode ver a quota para operações globais através da Google Cloud consola, da CLI Google Cloud e da API Service Usage. Para mais informações, consulte o artigo Veja as quotas e os limites de operações simultâneas.

Nome da quota Descrição	Nome da métrica	Métodos que consomem esta quota
Concurrent global operations per project Limita o número total de operações globais simultâneas para um projeto. Veja esta quota na Google Cloud consola	compute.googleapis.com/global_concurrent_operations	Todos os métodos globais. O URL do pedido HTTP contém global para estes métodos. Por exemplo, o método networks.insert: POST /compute/v1/projects/{project}/global/networks
Concurrent global operations per project operation type Limita o número de operações simultâneas por projeto e por tipo de operação. Veja esta quota na Google Cloud consola	compute.googleapis.com/global_concurrent_operations	Todos os métodos globais. A quota de operações simultâneas predefinida é de 500 operações em curso por projeto, exceto para os seguintes métodos, que têm limites predefinidos diferentes: globaladdresses.move firewalls.delete firewalls.insert images.delete images.deprecate images.insert images.patch images.setLabels images.setIamPolicy licenses.insert machineimages.delete machineimages.insert networks.addPeering networks.removePeering networks.updatePeering projects.setCommonInstaneMetadata publicAdvertisedPrefixes.delete publicAdvertisedPrefixes.insert routes.delete routes.insert securityPolicies.patchRule snapshots.delete snapshots.insert snapshots.setLabels snapshots.setIamPolicy snapshotSettings.patch

Quotas de operações regionais

As operações regionais simultâneas consomem um limite regional especificado para tipos de operações por projeto numa determinada região.

A tabela seguinte indica as quotas regionais para operações em curso e as métricas correspondentes.

Pode ver a quota para operações regionais através da Google Cloud consola, da CLI Google Cloud e da API Service Usage. Para mais informações, consulte o artigo Veja as quotas e os limites de operações simultâneas.

Nome da quota Descrição	Nome da métrica	Métodos que consomem esta quota
Concurrent regional operations per project Limita o número total de operações regionais simultâneas para um projeto. Veja esta quota na Google Cloud consola	compute.googleapis.com/regional_concurrent_operations	Todos os métodos regionais. O URL do pedido HTTP contém regions ou zones para estes métodos. Por exemplo, o método instances.insert: POST /compute/v1/projects/{project}/zones/{zone}/instances
Concurrent regional operations per project operation type Limita o número de operações regionais simultâneas por projeto e por tipo de operação. Veja esta quota na Google Cloud consola	compute.googleapis.com/regional_concurrent_operations	Todos os métodos regionais. A quota de operações simultâneas predefinida é de 500 operações em curso por projeto por região, exceto para os seguintes métodos, que têm limites predefinidos diferentes: addresses.move disks.insert instances.delete instances.insert instances.simulateMaintenanceEvent networkEndpointGroups.attachNetworkEndpoints networkEndpointGroups.detachNetworkEndpoints publicDelegatedPrefixes.delete publicDelegatedPrefixes.insert

Veja as quotas e os limites de operações simultâneas

Para ver a utilização e os limites de quota num projeto, faça o seguinte:

Consola

1. Na Google Cloud consola, aceda à página Quotas.

   Aceder a Quotas

   A página Quotas apresenta todos os limites e a utilização de quotas do seu projeto. Por predefinição, a lista é ordenada para mostrar primeiro as quotas mais usadas, o que ajuda a ver os limites que correm o risco de serem excedidos.

2. Para filtrar a lista e ver a utilização e o limite de uma quota específica, selecione Quota ou Métrica no campo Filtro.

   Por exemplo, selecione a quota Concurrent global operations per project operation type para ver a utilização da quota para métodos globais por tipo de operação.

   Para filtrar a quota de uma operação específica, adicione Dimensions à consulta de filtro e selecione operation_type. Por exemplo, selecione firewalls_insert para ver a utilização e o limite da quota para a operação firewalls.insert.

gcloud

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Pode usar a CLI do Google Cloud para ver a utilização e o limite das quotas de operações concorrentes.

Para usar esta abordagem, certifique-se de que instalou o componente de comandos alfa. Se estiver a usar o Cloud Shell para interagir com o Google Cloud, a CLI do Google Cloud é instalada automaticamente.

Para ver a quota, use o seguinte comando:

gcloud alpha services quota list \
    --service=compute.googleapis.com \
    --consumer=projects/PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto para o qual quer ver a quota.

Práticas recomendadas

A seguinte lista de verificação resume as práticas recomendadas para reduzir os erros de limite de operações concorrentes insuficientes:

• Aguarde a conclusão das operações
• Confie nos códigos de erro e não nas mensagens de erro
• Minimize as repetições do lado do cliente para preservar os limites de taxa da API
  • Evite a sondagem curta
  • Use o bursting com moderação e de forma seletiva
  • Faça sempre as suas chamadas num ciclo de repetição com retirada exponencial
  • Use um limitador de taxa do lado do cliente
  • Divida as suas aplicações em vários projetos

O que se segue?

• Leia sobre as cotas do Google Cloud.