Risolvere i problemi relativi agli errori di quota

Potresti ricevere errori di quota per una serie di motivi, ad esempio per aver superato i valori della quota o per non aver impostato correttamente la quota in un progetto. Se vuoi ricevere avvisi quando si verificano errori, puoi creare avvisi personalizzati per errori di quota specifici, come descritto in Configurare gli avvisi sulle quote.

Superamento delle quote di frequenza

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

Superamento dei valori di quota

Se il tuo progetto supera il valore massimo della quota durante l'utilizzo di un servizio, Google Cloud restituisce un errore in base a come hai eseguito l'accesso al servizio:

  • Se superi un valore di quota con una richiesta API, Google Cloud viene restituito un codice di stato HTTP413 REQUEST ENTITY TOO LARGE. Tieni presente che, quando utilizzi l'API di streaming precedente di BigQuery in un ambiente di produzione, potresti ricevere un codice di stato 413 REQUEST ENTITY TOO LARGE se le richieste HTTP sono più grandi di 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 viene restituito un codice di stato HTTP 429 TOO MANY REQUESTS.
  • Se superi una quota per Compute Engine, Google Cloud in genere viene restituito 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 viene restituito un errore ResourceExhausted. La modalità di visualizzazione di questo errore dipende dal servizio.
  • Se hai superato un valore di quota utilizzando un comando dell'interfaccia a riga di comando di Google Cloud, l'interfaccia a riga di comando gcloud mostra un messaggio di errore di superamento della quota e restituisce il codice di uscita 1.
  • Se hai ricevuto un messaggio QUOTA_EXCEEDED durante l'implementazione di un servizio, consulta la sezione seguente.

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

Google Cloud a volte modifica i valori di quota predefiniti per le risorse e le 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 visualizzare 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 una quota maggiore, puoi richiedere un aggiustamento 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 ulteriori informazioni, consulta la sezione Panoramica del progetto quota.

Errori di Google Cloud CLI

Questa sezione descrive i problemi comuni riscontrati durante l'utilizzo iniziale della riga di comando Google Cloud (gcloud CLI).

Installa e inizializza

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

  1. Installa la gcloud CLI.

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

  2. Inizializza la gcloud CLI.

  3. Installa il componente beta eseguendo il seguente comando:

    gcloud components install beta

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 al comando gcloud CLI per impostare esplicitamente il progetto quota o esegui di nuovo gcloud config set billing/quota_project CURRENT_PROJECT per impostare il progetto quota come progetto corrente.

Per ulteriori informazioni, consulta le seguenti risorse:

Aggiorna i componenti dell'interfaccia a riga di comando gcloud

Se ricevi un messaggio di errore che indica che il comando quote contiene un Invalid choice, è possibile che sia installata una versione precedente della CLI di gcloud. Aggiorna i componenti dell'interfaccia a riga di comando gcloud con il seguente comando:

gcloud components update

Per ulteriori dettagli sui comandi e sui flag gcloud beta quotas, consulta la sezione Quote di gcloud beta del riferimento della CLI Google Cloud.