Risolvere gli errori di quota

Potresti ricevere errori di quota per diversi motivi, ad esempio il superamento della quota non è l'impostazione corretta della quota su un progetto. Se vuoi ricevere un avviso in caso di errori, puoi creare avvisi personalizzati per di quota, come descritto Configura avvisi sulla quota.

Superamento delle quote di frequenza

Le quote di frequenza vengono reimpostate dopo un intervallo di tempo predefinito specifico completamente gestito di Google Cloud. Per ulteriori informazioni, consulta la documentazione sulle quote per il servizio specifico.

Superamento dei valori di quota

Se il progetto supera il valore massimo della quota durante l'utilizzo di un servizio, Google Cloud restituisce un errore in base alla modalità di accesso al servizio:

  • Se superi un valore di quota con una richiesta API, Google Cloud restituisce una richiesta HTTP Codice di stato 413 REQUEST ENTITY TOO LARGE. Tieni presente che, quando utilizzi l'API di flussi di dati legacy di BigQuery in un ambiente potresti ricevere un codice di stato 413 REQUEST ENTITY TOO LARGE se le richieste HTTP sono superiori a 10 MB. Potresti anche ricevere questo errore se superi i 300 MB al secondo. Per ulteriori informazioni, consulta la sezione Inserimento di flussi di dati.
  • Se hai superato un valore di quota con una richiesta HTTP/REST, Google Cloud restituisce un codice di stato HTTP 429 TOO MANY REQUESTS.
  • Se superi una quota per Compute Engine, in genere Google Cloud restituisce un codice di stato HTTP 403 QUOTA_EXCEEDED, che si tratti di API, HTTP/REST o gRPC. Se la quota è una quota tariffaria, viene restituito 403 RATE_LIMIT_EXCEEDED.
  • Se hai superato un valore di quota utilizzando gRPC, Google Cloud restituisce un errore ResourceExhausted. La modalità di visualizzazione di questo errore dipende dal servizio.
  • Se hai superato un valore di quota utilizzando un comando Google Cloud CLI, L'interfaccia a riga di comando gcloud restituisce un messaggio di errore di superamento della quota e restituisce con il codice di uscita 1.
  • Se hai ricevuto un messaggio QUOTA_EXCEEDED durante l'implementazione di un servizio, consulta la sezione che segue.

Superamento dei valori di quota durante l'implementazione di un servizio

A volte Google Cloud cambia i valori di quota predefiniti per le risorse e API. Queste modifiche vengono applicate gradualmente, il che significa che durante l'implementazione di una nuova quota predefinita, il valore della quota visualizzato nella console Google Cloud potrebbe non riflettere il nuovo valore della quota a tua disposizione.

Se è in corso l'implementazione di una quota, potresti ricevere un messaggio di errore che indica The future limit is the new default quota that will be available after a service rollout completes. Se visualizzi questo messaggio di errore, il valore della quota citato e il valore futuro sono corretti, anche se ciò che viene visualizzato nella console Google Cloud è diverso.

  • Per ulteriori informazioni, visualizza i log di controllo e cerca un messaggio QUOTA_EXCEEDED.

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

  • Per visualizzare i grafici che mostrano l'utilizzo corrente e di picco, vai alla pagina Quote e limiti di sistema e fai clic su Monitoraggio. Potresti dover andare alla fine della tabella.

  • Se hai bisogno di più quota, puoi richiedere un adeguamento della quota.

Messaggi di errore dell'API

Se il progetto quota (chiamato anche progetto di fatturazione) non è impostato correttamente, le richieste API potrebbero restituire messaggi di errore simili ai seguenti:

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

Spesso questi e altri errori possono essere corretti impostando il progetto quota. Per maggiori informazioni, consulta la panoramica del progetto di quota.

Errori di Google Cloud CLI

Questa sezione descrive i problemi comuni riscontrati quando si inizia a utilizzare il Google Cloud CLI (gcloud CLI).

Installa e inizializza

Per utilizzare gcloud CLI per le quote di Cloud, assicurati di installare e inizializzare i componenti:

  1. Installa gcloud CLI.

    Se utilizzi Cloud Shell, puoi saltare questo passaggio perché È preinstallato gcloud CLI.

  2. Inizializza gcloud CLI.

  3. Installa il componente alpha eseguendo il seguente comando:

    gcloud components install alpha

Imposta il progetto della quota

Se non hai impostato il progetto quota, i comandi gcloud CLI potrebbero restituire un errore simile al seguente:

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.

Per risolvere il problema, aggiungi il flag --billing-project alla tua il comando gcloud CLI per impostare in modo esplicito il progetto di quota oppure esegui nuovamente gcloud config set billing/quota_project CURRENT_PROJECT per impostare il progetto di quota del progetto attuale.

Per ulteriori informazioni, consulta le seguenti risorse:

Aggiorna i componenti della gcloud CLI

Se viene visualizzato un errore che indica che il comando quote contiene un'istruzione Invalid choice, potresti avere installato una versione precedente di gcloud CLI. Aggiorna i componenti della gcloud CLI con il seguente comando:

gcloud components update

Per ulteriori dettagli sui comandi e sui flag gcloud alpha quotas, consulta le quote gcloud alpha del riferimento per Google Cloud CLI.