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, Cloud de Confiance by S3NS 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, Cloud de Confiance by S3NS o Google Cloud retornará um código de status HTTP 413 REQUEST ENTITY TOO LARGE status code. 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, Cloud de Confiance by S3NS retornará um código de status 429 TOO MANY REQUESTS.
  • Se você exceder uma cota do Compute Engine, Cloud de Confiance by S3NS o Google Cloud normalmente retornará um código de status403 QUOTA_EXCEEDED HTTP, seja da API, do HTTP/REST, ou do gRPC. Se a cota for uma cota de taxa, será retornado 403 RATE_LIMIT_EXCEEDED.
  • Se você tiver excedido uma cota usando gRPC, Cloud de Confiance by S3NS o Google Cloud retornará um ResourceExhausted erro. 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

Cloud de Confiance by S3NS À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 Cloud de Confiance console 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 que afirma 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 que aparece no Cloud de Confiance console seja 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 conferir gráficos que mostram o uso atual e o pico de uso, no Cloud de Confiance console, acesse a página IAM e administrador > Cotas e limites do sistema e clique em Monitoramento. Talvez seja necessário ir até o fim da tabela.

  • Se você precisar de mais cota, você pode solicitar um ajuste de cota.

Exceder a cota do projeto

Para mais informações sobre como solicitar cotas adicionais do projeto, consulte o Solicitações de cotas do projeto artigo de suporte.

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 mensagens de erro semelhantes a esta:

  • 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.

Erros da CLI do Google Cloud

Esta seção descreve problemas comuns encontrados ao começar a usar a CLI do Google Cloud (gcloud CLI).

Instalar e inicializar

Para usar a CLI gcloud para cotas do Cloud, instale e inicialize os componentes:

  1. Instale a CLI gcloud.

    Se você estiver usando o Cloud Shell, pule esta etapa porque a gcloud CLI vem pré-instalada.

  2. Inicialize a CLI gcloud.

  3. Instale o componente Beta executando o seguinte comando:

    gcloud components install beta

Definir o projeto de cota

Se você não tiver definido seu projeto de cota, os comandos da gcloud CLI poderão retornar um erro como este:

PERMISSION_DENIED: Your application is authenticating by using local Application Default Credentials.
The cloudquotas.googleapis.com API requires a quota project, which is not set by default.

Para resolver esse problema, adicione a flag --billing-project ao comando CLI gcloud para definir explicitamente o projeto de cota ou execute novamente gcloud config set billing/quota_project CURRENT_PROJECT para definir o projeto de cota como o projeto atual.

Para ver mais informações, consulte os seguintes tópicos:

Atualizar componentes da CLI gcloud

Se você receber um erro informando que o comando de cotas contém um Invalid choice, é possível que você tenha uma versão mais antiga da CLI gcloud instalada. Atualize os componentes da CLI gcloud com o comando a seguir:

gcloud components update

Para mais detalhes sobre comandos e flags gcloud beta quotas, consulte a gcloud beta quotas seção da referência da Google Cloud CLI.

A seguir