Resolva problemas de erros de quota

Pode receber erros de quota por vários motivos, como exceder os valores de quota ou não definir a quota num projeto corretamente. Se quiser receber alertas quando ocorrerem erros, pode criar alertas personalizados para erros de quota específicos, conforme descrito em Configure alertas de quota.

Exceder quotas de taxa

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

Exceder os valores de quota

Se o seu projeto exceder o valor máximo da quota enquanto usa um serviço, Google Cloud devolve um erro com base na forma como acedeu ao serviço:

• Se exceder um valor de quota com um pedido de API, Google Cloud é devolvido um código de estado HTTP 413 REQUEST ENTITY TOO LARGE. Tenha em atenção que, quando usar a API BigQuery Legacy Streaming num ambiente de produção, pode receber um código de estado 413 REQUEST ENTITY TOO LARGE se os seus pedidos HTTP forem superiores a 10 MB. Também pode receber este erro se exceder 300 MB por segundo. Para mais informações, consulte o artigo Inserções de streaming.
• Se excedeu um valor de quota com um pedido HTTP/REST, Google Cloud é devolvido um código de estado HTTP 429 TOO MANY REQUESTS.
• Se exceder uma quota do Compute Engine, Google Cloud normalmente, é devolvido um código de estado HTTP 403 QUOTA_EXCEEDED, quer tenha sido a partir da API, HTTP/REST ou gRPC. Se a quota for uma quota de taxa, é devolvido 403 RATE_LIMIT_EXCEEDED.
• Se excedeu um valor de quota através do gRPC, Google Cloud é devolvido um erro ResourceExhausted. A forma como este erro lhe é apresentado depende do serviço.
• Se excedeu um valor de quota através de um comando da CLI do Google Cloud, a CLI gcloud apresenta uma mensagem de erro de quota excedida e devolve com o código de saída 1.
• Se recebeu uma mensagem QUOTA_EXCEEDED durante a implementação de um serviço, consulte a secção seguinte.

Exceder os valores da quota durante a implementação de um serviço

Google Cloud por vezes, altera os valores de quota predefinidos para recursos e APIs. Estas alterações ocorrem gradualmente, o que significa que, durante a implementação de uma nova quota predefinida, o valor da quota apresentado na Google Cloud consola pode não refletir o novo valor da quota disponível para si.

Se estiver em curso uma implementação de quota, pode receber uma mensagem de erro que indique The future limit is the new default quota that will be available after a service rollout completes. Se vir esta mensagem de erro, o valor da quota citado e o valor futuro estão corretos, mesmo que o que aparece na Google Cloud consola seja diferente.

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

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

• Para ver gráficos que mostram a utilização atual e máxima, na Google Cloud consola, aceda à página IAM e administração > Quotas e limites do sistema e, de seguida, clique em monitoringMonitorização. Pode ter de ir para o fim da tabela.

• Se precisar de mais quota, pode pedir um ajuste da quota.

Exceder a quota do projeto

Para mais informações sobre como pedir quotas de projetos adicionais, consulte o artigo de apoio técnico Pedidos de quotas de projetos.

Mensagens de erro da API

Se o projeto de quota (também denominado projeto de faturação) não estiver definido corretamente, os pedidos de API podem devolver mensagens de erro semelhantes às seguintes:

• User credentials not supported by this API
• API not enabled in the project
• No quota project set

Estes e outros erros podem ser frequentemente corrigidos definindo o projeto de quota. Para mais informações, consulte o artigo Vista geral do projeto de quotas.

Erros da CLI do Google Cloud

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

Instale e inicialize

Para usar a CLI gcloud para as quotas do Google Cloud, certifique-se de que instala e inicializa os componentes:

1. Instale a CLI gcloud.

   Se estiver a usar o Cloud Shell, pode ignorar este passo porque a CLI gcloud vem pré-instalada.

2. Inicialize a CLI gcloud.

3. Instale o componente beta executando o seguinte comando:

   gcloud components install beta
   

Defina o projeto de quota

Se não tiver definido o projeto de quota, os comandos da CLI gcloud podem devolver um erro semelhante ao seguinte:

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 este problema, adicione a flag --billing-project no comando da CLI gcloud para definir explicitamente o projeto de quota ou execute novamente gcloud config set billing/quota_project CURRENT_PROJECT para definir o projeto de quota como o projeto atual.

Para mais informações, consulte o seguinte:

• Defina o projeto de quota de forma programática.
• Defina o projeto de faturação através da CLI gcloud.

Atualize os componentes da CLI gcloud

Se receber um erro a indicar que o comando quotas contém um Invalid choice, pode ter uma versão mais antiga da CLI gcloud instalada. Atualize os componentes da CLI gcloud com o seguinte comando:

gcloud components update

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