Résoudre les erreurs de quota

Vous pouvez recevoir des erreurs de quota pour plusieurs raisons, telles que le dépassement des valeurs de quota ou la mauvaise définition du projet de quota. Si vous souhaitez être averti lorsque des erreurs se produisent à l'avenir, vous pouvez créer des alertes personnalisées pour des erreurs de quota spécifiques, comme décrit dans la section Configurer des alertes de quota.

Dépassement des quotas de débit

Les quotas de débit sont réinitialisés après un intervalle prédéfini spécifique à chaque service. Pour en savoir plus, consultez la documentation sur les quotas d'un service spécifique.

Dépassement des valeurs de quota

Si votre projet dépasse sa valeur de quota maximale lors de l'utilisation d'un service, Google Cloud renvoie une erreur en fonction de la manière dont vous avez accédé au service :

  • Si vous dépassez une valeur de quota avec une requête API, Google Cloud renvoie un code d'état HTTP 413 REQUEST ENTITY TOO LARGE. Notez que lorsque vous utilisez l'ancienne API de diffusion BigQuery dans un environnement de production, vous pouvez recevoir un code d'état 413 REQUEST ENTITY TOO LARGE si vos requêtes HTTP dépassent 10 Mo. Vous pouvez également recevoir cette erreur si vous dépassez 300 Mo par seconde. Pour en savoir plus, consultez la page Insertions en flux continu.
  • Si vous avez dépassé une valeur de quota avec une requête HTTP/REST, Google Cloud renvoie un code d'état HTTP 429 TOO MANY REQUESTS.
  • Si vous dépassez un quota pour Compute Engine, Google Cloud renvoie généralement un code d'état HTTP 403 QUOTA_EXCEEDED, qu'il provienne d'une API, de HTTP/REST ou de gRPC. Si le quota est un quota de débit, la valeur 403 RATE_LIMIT_EXCEEDED est renvoyée.
  • Si vous avez dépassé une valeur de quota avec gRPC, Google Cloud renvoie une erreur ResourceExhausted. La manière dont cette erreur s'affiche dépend du service.
  • Si vous avez dépassé une valeur de quota avec une commande Google Cloud CLI, gcloud CLI génère un message d'erreur de dépassement de quota, puis affiche le code de sortie 1.
  • Si vous avez reçu un message QUOTA_EXCEEDED lors d'un déploiement de service, consultez la section suivante.

Dépassement des valeurs de quota lors d'un déploiement de service

Google Cloud modifie parfois les valeurs de quota par défaut des ressources et des API. Ces modifications ont lieu progressivement, ce qui signifie que lors du déploiement d'un nouveau quota par défaut, la valeur de quota qui s'affiche dans la console Google Cloud ne reflète peut-être pas la nouvelle valeur de quota disponible.

Si un déploiement de quota est en cours, vous pouvez recevoir un message d'erreur indiquant The future limit is the new default quota that will be available after a service rollout completes.. Si ce message d'erreur s'affiche, la valeur du quota cité et la valeur future sont correctes, même si ce qui s'affiche dans la console Google Cloud est différent.

  • Pour en savoir plus, affichez les journaux d'audit et recherchez un message QUOTA_EXCEEDED.

        "status": {
          ...
          "message": "QUOTA_EXCEEDED",
          "details": [
            {
              ...
              "value": {
                "quotaExceeded": {
                  ...
                  "futureLimit": FUTUREVALUE
                }
              }
            }
          ]
        },
    
  • Pour afficher des graphiques indiquant l'utilisation actuelle et maximale, dans la console Google Cloud, cliquez sur l'icône de surveillance monitoring. Vous devrez peut-être faire défiler la page vers la droite pour voir cette icône.

  • Si vous avez besoin d'un quota supérieur à celui auquel vous avez accès et que vous ne pouvez pas attendre la fin du déploiement du service, demandez un ajustement de quota.

Messages d'erreur de l'API

Si votre projet de quota (également appelé projet de facturation) n'est pas correctement défini, les requêtes API peuvent renvoyer les messages d'erreur suivants :

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

Ces erreurs et d'autres erreurs peuvent souvent être corrigées en définissant le projet de quota. Pour en savoir plus, consultez la page Présentation des projets de quota.