Risoluzione dei problemi

Questa pagina contiene informazioni sulla risoluzione dei problemi per ogni versione delle seguenti API per l'infrastruttura di servizi:

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

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

L'API Service Control fornisce funzionalità del piano di controllo, come il logging e il monitoraggio nei servizi gestiti. Pertanto, i chiamanti dell'API Service Control sono generalmente applicazioni server. Ecco suggerimenti generali su come gestire gli errori a livello di API REST/RPC:

  • Il server dovrebbe registrare tutti gli errori restituiti dall'API Service Control e tu puoi utilizzare i dati per risolvere il problema del tuo servizio gestito.
  • Se il server riceve errori 429 dall'API Service Control, dovrebbe restituire errori 429 ai client.
  • Se il server non è in grado di accedere all'API Service Control, può scegliere di eseguire l'operazione non riuscita (ignorare l'errore) o la chiusura (restituire 503 al client).
  • Se il server riceve errori 500 dall'API Service Control, dovrebbe restituire un errore 500 ai suoi client. Questi errori di solito significano bug all'interno dell'API Service Control.
  • Se il server riceve altri errori dall'API Service Control, dovrebbe restituire un errore 500 ai suoi client. Questi errori di solito significano bug all'interno del tuo servizio gestito.

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

Per utilizzare qualsiasi servizio API di Google, devi avere un progetto Google Cloud, abilitare il servizio per il progetto e passare una chiave API o un token di accesso OAuth associato al progetto per ogni richiesta API. Per ulteriori dettagli, consulta la Guida all'autenticazione. Per correggere questo errore, devi abilitare il servizio per il tuo progetto utilizzando la console Google Cloud, Google Cloud CLI o l'API Service Usage. Per informazioni su come abilitare un servizio, vedi Attivazione e disattivazione dei servizi.

Come posso correggere gli errori di autorizzazione negata?

Questi errori in genere significano che il chiamante non dispone dell'autorizzazione Identity and Access Management corretta su determinate risorse. Per informazioni sulle autorizzazioni richieste per ciascuna delle seguenti API dell'infrastruttura di servizi, consulta la rispettiva pagina di controllo degli accessi:

Come si esegue un nuovo tentativo per errori dell'API?

Si consiglia di eseguire un nuovo tentativo con intervalli esponenziali più casualità. L'intervallo minimo tra i tentativi deve essere di 30 secondi per gli errori di quota 429 e di 1 secondi per gli errori del server 500 e 503. Per altri errori, l'esecuzione di un nuovo tentativo deve essere eseguita solo in base a ulteriori informazioni sugli errori. Per ulteriori dettagli, visita google.rpc.Code.

Come faccio a richiedere una quota API più elevata?

Per informazioni su come richiedere una quota più alta per ciascuna delle seguenti API per l'infrastruttura di servizi, visita la rispettiva sezione della pagina Quote e limiti:

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

Questo errore indica che il chiamante non è proprietario del nome di dominio utilizzato per il nome del servizio gestito specificato in una configurazione del servizio. Segui la guida per utilizzare un dominio valido.