Risoluzione dei problemi

Questa pagina contiene informazioni sulla risoluzione dei problemi per ogni versione delle seguenti API Service Infrastructure:

  • API Service Management
  • API Service Control
  • API Service Consumer Management

Come faccio a gestire gli errori dell'API Service Control in generale?

L'API Service Control fornisce funzionalità del piano di controllo, come logging e monitoraggio, ai servizi gestiti. Pertanto, gli utenti che chiamano l'API Service Control sono in genere applicazioni server. Di seguito sono riportati alcuni consigli generali su come gestire gli errori a livello di API REST/RPC:

  • Il server deve registrare tutti gli errori restituiti dall'API Service Control e puoi utilizzare i dati per risolvere i problemi del servizio gestito.
  • Se il server riceve errori 429 dall'API Service Control, deve restituire errori 429 ai client.
  • Se il server non può accedere all'API Service Control, può scegliere tra il comportamento fail-open (ignora l'errore) o fail-close (restituisce 503 al suo cliente).
  • Se il server riceve errori 500 dall'API Service Control, deve restituire l'errore 500 ai client. Questi errori di solito indicano bug all'interno dell'API Service Control.
  • Se il server riceve altri errori dall'API Service Control, deve restituire l'errore 500 ai clienti. In genere, questi errori indicano bug all'interno del servizio gestito.

Che cosa significa l'errore "Servizio non abilitato"?

Per utilizzare qualsiasi servizio API di Google, devi disporre di un progetto Google Cloud, attivare il servizio per il progetto e passare una chiave API o un token di accesso OAuth associato al progetto per ogni richiesta API. Per maggiori dettagli, consulta la guida all'autenticazione. Per correggere questo errore, devi attivare il servizio per il tuo progetto utilizzando la console Google Cloud, Google Cloud CLI o l'API Service Usage. Per scoprire come attivare un servizio, consulta Abilitazione e disattivazione dei servizi.

Come faccio a correggere gli errori di autorizzazione negata?

In genere, questi errori indicano che il chiamante non dispone dell'autorizzazione Identity and Access Management corretta per determinate risorse. Per informazioni sulle autorizzazioni richieste per ciascuna delle seguenti API Service Infrastructure, consulta la rispettiva pagina di controllo dell'accesso:

Come faccio a eseguire un nuovo tentativo in caso di errori dell'API?

Ti consigliamo di eseguire un nuovo tentativo con intervalli esponenziali e casualità. L'intervallo di ripetizione minimo deve essere di 30 secondi per gli errori di quota 429; 1 secondo per gli errori di server 500 e 503. Per altri errori, il nuovo tentativo deve essere eseguito solo in base a informazioni aggiuntive sull'errore. Per ulteriori dettagli, consulta google.rpc.Code.

Come faccio a richiedere una quota API più alta?

Per scoprire come richiedere una quota superiore per ciascuna delle seguenti API Service Infrastructure, visita la rispettiva sezione della pagina Quote e limiti:

Come faccio a correggere gli errori "Impossibile verificare la proprietà del nome di dominio"?

Questo errore indica che l'utente che ha effettuato la chiamata non possiede il nome di dominio utilizzato per il nome del servizio gestito specificato in una configurazione del servizio. Segui la guida per utilizzare un dominio valido.