Resolver erros de cota

Erros de cota podem ocorrer por vários motivos, como exceder valores de cota ou não definir a cota em um projeto corretamente. Se você quiser receber um alerta quando ocorrer erros no futuro, crie alertas personalizados para erros de cota específicos, conforme descrito em Configurar alertas de cota.

Cotas de taxa excedentes

As cotas de taxa são redefinidas após um intervalo de tempo predefinido específico de cada serviço. Para mais informações, consulte a documentação de cotas do serviço específico.

Valores de cota excedentes

Se o projeto exceder o valor máximo da cota ao usar um serviço, o Google Cloud retornará um erro com base em como você acessou o serviço:

  • Se você exceder uma cota com uma solicitação de API, o Google Cloud retornará um código de status HTTP 413 REQUEST ENTITY TOO LARGE. Ao usar a API de streaming legada do BigQuery em um ambiente de produção, você poderá receber um código de status 413 REQUEST ENTITY TOO LARGE se as solicitações HTTP forem maiores que 10 MB. Esse erro também poderá ser exibido se você exceder 300 MB por segundo. Para mais informações, consulte Inserções por streaming.
  • Se você tiver excedido uma cota com uma solicitação HTTP/REST, o Google Cloud retornará um código de status HTTP 429 TOO MANY REQUESTS.
  • Se você exceder uma cota do Compute Engine, o Google Cloud normalmente retornará um código de status HTTP 403 QUOTA_EXCEEDED, seja da API, do HTTP/REST ou do gRPC. Se a cota for uma cota de taxa, 403 RATE_LIMIT_EXCEEDED será retornado.
  • Se você tiver excedido uma cota usando o gRPC, o Google Cloud retornará um erro ResourceExhausted. A forma como esse erro aparece para você depende do serviço.
  • Se você excedeu uma cota usando um comando da CLI do Google Cloud, a CLI gcloud gera uma mensagem de erro que excede a cota e retorna com o código de saída 1.
  • Se você recebeu uma mensagem QUOTA_EXCEEDED durante uma distribuição de serviço, consulte a próxima seção.

Exceder valores de cota durante uma distribuição de serviço

Às vezes, o Google Cloud altera os valores de cota padrão para recursos e APIs. Essas mudanças ocorrem gradualmente, o que significa que, durante o lançamento de uma nova cota padrão, o valor da cota que aparece no console do Google Cloud pode não refletir o novo valor da cota disponível para você.

Se o lançamento de uma cota estiver em andamento, talvez você receba a mensagem de erro The future limit is the new default quota that will be available after a service rollout completes. Se essa mensagem de erro for exibida, significa que o valor da cota citado e o valor futuro estão corretos, mesmo que o console do Google Cloud mostre algo diferente.

  • Para mais informações, consulte os registros de auditoria e procure uma mensagem QUOTA_EXCEEDED.

        "status": {
      ...
      "message": "QUOTA_EXCEEDED",
      "details": [
        {
          ...
          "value": {
            "quotaExceeded": {
              ...
              "futureLimit": FUTUREVALUE
            }
          }
        }
      ]
    },

  • Para ver gráficos que mostram o uso atual e o pico, no console do Google Cloud, clique no ícone de monitoramento do monitoring. Talvez seja necessário rolar toda a tela para a direita para ver esse ícone.

  • Se você precisar de uma cota maior do que aquela a que tem acesso e não puder esperar até que a distribuição de serviço seja concluída, solicite um ajuste de cota.

Mensagens de erro da API

Se o projeto de cota (também chamado de projeto de faturamento) não estiver definido corretamente, as solicitações de API poderão retornar as seguintes mensagens de erro:

  • user credentials not supported by this API
  • API not enabled in the project
    • no quota project set

Esses e outros erros geralmente podem ser corrigidos ao definir o projeto de cota. Para mais informações, consulte Visão geral do projeto de cota.

Mensagens de erro da cota compartilhada dinâmica

Se o número de solicitações exceder a capacidade alocada para processar essas solicitações a cota compartilhada dinâmica poderá gerar o código de erro 429 ao usar os seguintes produtos:

Produto Mensagem
Pagamento por uso (paygo) Resource exhausted, please try again later.
Capacidade de processamento provisionada Too many requests. Exceeded the provisioned throughput.

Para corrigir o problema, faça o seguinte:

  • Envie sua solicitação novamente usando a espera exponencial.
  • Se você definiu uma substituição do consumidor, como uma medida de controle de custos ou para evitar estourar o orçamento, aumente o limite. Para mais informações, consulte Cota compartilhada dinâmica.
  • Considere usar a capacidade de processamento provisionada para ter um nível de serviço mais consistente. Para mais informações, entre em contato com a equipe de vendas do Google Cloud.