Cotas de operação simultânea do Compute Engine

---

Neste documento, descrevemos as cotas de operações simultâneas do Compute Engine.

Cotas de operação simultânea

As cotas de operações simultâneas definem o número de operações simultâneas ou em andamento que podem ocorrer a qualquer momento. Qualquer solicitação de API que cria, modifica ou exclui um recurso do Compute Engine está sujeita a uma verificação de limite de operação simultânea para garantir que o número total de operações em trânsito em qualquer ponto não exceda o limite especificado para essa operação.

Erro de limite de operação simultânea excedido

Se o projeto exceder o limite de operações simultâneas para qualquer operação em trânsito, você receberá um erro 403 com o motivo rateLimitExceededs

A resposta da API do erro é semelhante a:

    "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",
          "metadatas": {
            "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 em que a cota excede o limite.

• QUOTA_METRIC: a métrica da cota simultânea que excede o limite. Pode ser um destes:

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

• QUOTA_LIMIT: o nome do limite da cota simultânea. Pode ser um destes:

  • GlobalConcurrentOperationsPerProject
  • GlobalConcurrentOperationsPerProjectOperationType
  • RegionalConcurrentOperationsPerProject
  • RegionalConcurrentOperationsPerProjectOperationType

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

• O location pode ser um dos seguintes:

  • global: especifica que o limite foi excedido para a cota de operação global.
  • REGION: especifica a região onde o limite foi excedido para a cota de operação.

Os registros detalhados de erros são retornados somente pela resposta da API. O erro na Análise de registros é 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 de API em que o limite de taxa foi excedido. Por exemplo, v1.compute.instances.stop.

Grupos de cotas de operações simultâneas

Nesta seção, descrevemos os limites de várias operações em trânsito ou em tempo real do Compute Engine.

Cotas de operação globais

Operações globais simultâneas consomem um limite global especificado para os tipos de operação por projeto. A tabela a seguir lista as cotas globais para operações em andamento e as métricas correspondentes.

É possível visualizar a cota de operações globais usando o console do Google Cloud, a CLI do Google Cloud e a API Service Usage. Para mais informações, consulte Visualizar cotas e limites de operações simultâneas.

Nome da cota Descrição	Nome da métrica	Métodos que consomem esta cota
Concurrent global operations per project Limita o número total de operações globais simultâneas de um projeto. Veja esta cota no console do Google Cloud	compute.googleapis.com/global_concurrent_operations	Todos os métodos globais. O URL da solicitação HTTP contém global para esses 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 por tipo de operação. Veja esta cota no console do Google Cloud	compute.googleapis.com/global_concurrent_operations	Todos os métodos globais. A cota padrão de operações simultâneas é de 500 operações em andamento por projeto, exceto pelos métodos a seguir, que têm limites padrão 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

Cotas de operação regional

Operações regionais simultâneas consomem um limite regional especificado para os tipos de operação por projeto em uma determinada região.

A tabela a seguir lista as cotas regionais para operações em andamento e as métricas correspondentes.

É possível visualizar a cota de operações regionais usando o console do Google Cloud, a CLI do Google Cloud e a API Service Usage. Para mais informações, consulte Visualizar cotas e limites de operações simultâneas.

Nome da cota Descrição	Nome da métrica	Métodos que consomem esta cota
Concurrent regional operations per project Limita o número total de operações globais simultâneas de um projeto. Veja esta cota no console do Google Cloud	compute.googleapis.com/regional_concurrent_operations	Todos os métodos regionais. O URL da solicitação HTTP contém regions ou zones para esses 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 por tipo de operação. Veja esta cota no console do Google Cloud	compute.googleapis.com/regional_concurrent_operations	Todos os métodos regionais. A cota padrão de operações simultâneas é de 500 operações em andamento por projeto e por região, exceto pelos métodos a seguir, que têm limites padrão diferentes: addresses.move disks.insert instances.delete instances.insert instances.simulateMaintenanceEvent networkEndpointGroups.attachNetworkEndpoints networkEndpointGroups.detachNetworkEndpoints publicDelegatedPrefixes.delete publicDelegatedPrefixes.insert

Visualizar cotas e limites de operações simultâneas

Para visualizar o uso e os limites de cota em um projeto, faça o seguinte:

Console

1. No Console do Google Cloud, acesse a página Cotas.

   Acessar "Cotas"

   A página Cotas lista todo o uso e os limites das cotas para seu projeto. A lista é classificada por padrão para mostrar primeiramente as cotas mais usadas, o que ajuda a ver os limites que correm risco de serem excedidos.

2. Para filtrar a lista e ver o uso e o limite de uma cota específica, selecione a Cota ou a Métrica no campo Filtro.

   Por exemplo, selecione a Cota Concurrent global operations per project operation type para saber o uso da cota para métodos globais por tipo de operação.

   Para filtrar a cota de uma operação específica, adicione Dimensões à consulta de filtro e selecione operation_type. Por exemplo, selecione firewalls_insert para ver o uso da cota e o limite da operação firewalls.insert.

gcloud

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Use a CLI do Google Cloud para ver o uso e o limite de cotas de operação simultânea.

Para usar essa abordagem, instale o componente de comandos alfa. Se você estiver usando o Cloud Shell para interagir com o Google Cloud, a CLI do Google Cloud será instalada.

Para conferir a cota, use o seguinte comando:

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

Substitua PROJECT_ID pelo ID do projeto com a cota que você quer visualizar.

Práticas recomendadas

A lista de verificação a seguir resume as práticas recomendadas para reduzir erros de limite de operações simultâneas insuficientes:

• Aguardar operações serem concluídas
• Conte com códigos de erro, não mensagens de erro
• Minimize novas tentativas do lado do cliente para preservar os limites da taxa de API
  • Evite pesquisas curtas
  • Use o bursting com moderação e seletivamente
  • Sempre faça chamadas em um loop de repetição com espera exponencial
  • Use uma limitação de taxa no lado do cliente
  • Divida seus aplicativos em vários projetos

A seguir

• Leia sobre as cotas do Google Cloud.