Risolvi i problemi relativi agli errori di quota

Potresti ricevere errori di quota per diversi motivi, ad esempio il superamento dei valori di quota o l'impostazione errata della quota in un progetto. Se vuoi ricevere una notifica quando si verificano errori, puoi creare avvisi personalizzati per errori di quota specifici, come descritto in Configurare gli avvisi di quota.

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 restituisce un codice di stato HTTP 413 REQUEST ENTITY TOO LARGE Tieni presente che, quando utilizzi l'API BigQuery legacy per lo streaming in un ambiente di produzione, potresti ricevere un codice di stato 413 REQUEST ENTITY TOO LARGE se le tue richieste HTTP sono maggiori di 10 MB. Potresti ricevere questo errore anche se superi i 300 MB al secondo. Per ulteriori informazioni, consulta la pagina relativa agli inserimenti di flussi di dati. Streaming inserts.
  • Se hai superato un valore di quota con una richiesta HTTP/REST, Google Cloud restituisce un codice di stato 429 TOO MANY REQUESTS HTTP.
  • Se superi una quota per Compute Engine, Google Cloud in genere restituisce un codice di stato 403 QUOTA_EXCEEDEDHTTP, indipendentemente dal fatto che provenga da API, HTTP/REST, o gRPC. Se la quota è una quota di frequenza, viene restituito 403 RATE_LIMIT_EXCEEDED.
  • Se hai superato un valore di quota utilizzando gRPC, Google Cloud restituisce un ResourceExhausted errore. La modalità di visualizzazione di questo errore dipende dal servizio.
  • Se hai superato un valore di quota utilizzando un comando Google Cloud CLI, gcloud CLI mostra un messaggio di errore di superamento della quota e restituisce il codice di uscita 1.
  • Se hai ricevuto un messaggio QUOTA_EXCEEDED durante il lancio di un servizio, consulta la sezione seguente.

Superamento dei valori di quota durante il lancio di un servizio

Google Cloud Occasionalmente,modifica i valori di quota predefiniti per le risorse e le API. Queste modifiche vengono apportate gradualmente, il che significa che durante il lancio di una nuova quota predefinita, il valore di quota visualizzato nella Google Cloud console potrebbe non riflettere il nuovo valore di quota a tua disposizione.

Se è in corso il lancio 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 di quota citato e il valore futuro sono corretti, anche se ciò che viene visualizzato nella Google Cloud console è diverso.

Superamento della quota del progetto

Per ulteriori informazioni sulla richiesta di quote di progetto aggiuntive, consulta l' articolo di assistenza Richieste di quote di progetto.

Messaggi di errore dell'API

Se il progetto di 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

Questi e altri errori possono spesso essere corretti impostando il progetto di quota. Per ulteriori 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 Google Cloud CLI (gcloud CLI).

Installazione e inizializzazione

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é gcloud CLI è preinstallato.

  2. Inizializza gcloud CLI.

  3. Installa il componente beta eseguendo il seguente comando:

    gcloud components install beta
    

Imposta il progetto di quota

Se non hai impostato il progetto di 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 di quota oppure esegui di nuovo gcloud config set billing/quota_project CURRENT_PROJECT per impostare il progetto di quota come progetto corrente.

Per ulteriori informazioni, consulta le seguenti risorse:

Aggiorna i componenti di gcloud CLI

Se ricevi un errore che indica che il comando quotas contiene una Invalid choice, potresti aver installato una versione precedente di gcloud CLI. Aggiorna i componenti di gcloud CLI con il seguente comando:

gcloud components update

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

Passaggi successivi