Risolvere i problemi relativi agli errori di quota

Potresti ricevere errori relativi alla 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 della quota massima 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 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 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 dellGoogle Cloud CLI, l'interfaccia alla 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 l'implementazione di un servizio, consulta la sezione seguente.

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

A volte Google Cloud modifica i valori predefiniti delle quote 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 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 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 di 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 la gcloud CLI.

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

  2. Inizializza la 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 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 gcloud CLI. 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 alpha quotas, consulta la sezione Quote di gcloud alpha del riferimento di Google Cloud CLI.