Risolvere gli errori di quota

Potresti ricevere errori di quota per diversi motivi, ad esempio il superamento dei valori di quota o la mancata impostazione corretta della quota su un progetto. Se vuoi ricevere avvisi quando si verificano errori, puoi creare avvisi personalizzati per errori di quota specifici, come descritto in Configurare avvisi sulle quote.

Superamento delle quote di frequenza

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

Superamento dei valori della quota

Se il progetto supera il valore di quota massima 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 un codice di stato HTTP 413 REQUEST ENTITY TOO LARGE. Tieni presente che quando utilizzi l'API di streaming legacy di BigQuery in un ambiente di produzione, potresti ricevere un codice di stato 413 REQUEST ENTITY TOO LARGE se le tue richieste HTTP sono superiori a 10 MB. Potresti visualizzare questo errore anche se superi i 300 MB al secondo. Per ulteriori informazioni, consulta 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, Google Cloud in genere restituisce un codice di stato HTTP 403 QUOTA_EXCEEDED, che proveniva 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 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, gcloud CLI restituisce un messaggio di errore che supera la 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 cambia i valori di quota predefiniti per risorse e API. Queste modifiche avvengono gradualmente, il che significa che durante l'implementazione di una nuova quota predefinita, il valore di quota visualizzato nella console Google Cloud potrebbe non riflettere il nuovo valore di quota a tua disposizione.

Se è in corso un'implementazione della quota, potresti ricevere un messaggio di errore che indica che The future limit is the new default quota that will be available after a service rollout completes..

  • Per ulteriori informazioni, visualizza gli audit log e cerca un messaggio QUOTA_EXCEEDED.

        "status": {
          ...
          "message": "QUOTA_EXCEEDED",
          "details": [
            {
              ...
              "value": {
                "quotaExceeded": {
                  ...
                  "futureLimit": FUTUREVALUE
                }
              }
            }
          ]
        },
    
  • Per visualizzare i grafici che mostrano l'utilizzo attuale e di picco, fai clic sull'icona di monitoraggio monitoring nella console Google Cloud. Potrebbe essere necessario scorrere fino a destra per vedere l'icona.

  • Se hai bisogno di una quota superiore a quella a cui hai accesso e non puoi attendere il completamento dell'implementazione del servizio, richiedi un adeguamento della quota.

Messaggi di errore relativi all'API

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

  • 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 di quota. Per maggiori informazioni, consulta la panoramica del progetto di quota.

Messaggi di errore relativi alla quota condivisa dinamica

Se il numero delle tue richieste supera la capacità allocata per elaborare queste richieste, la quota dinamica condivisa potrebbe generare il codice di errore 429 quando utilizzi i seguenti prodotti:

Prodotto Messaggio
Pagamento a consumo (paygo) Resource exhausted, please try again later.
Velocità effettiva di cui è stato eseguito il provisioning Too many requests. Exceeded the provisioned throughput.

Per risolvere il problema:

  • Invia di nuovo la richiesta utilizzando il backoff esponenziale.
  • Se hai impostato un override del consumatore, ad esempio una misura per il controllo dei costi o per evitare il superamento del budget, aumenta il limite. Per maggiori informazioni, consulta Quota condivisa dinamica.
  • Valuta la possibilità di utilizzare la velocità effettiva sottoposta a provisioning per un livello di servizio più coerente. Per saperne di più, contatta il team di vendita Google Cloud.