Risoluzione dei problemi

Questa pagina contiene informazioni per la 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 control plane, come logging e monitoraggio, ai servizi gestiti. Pertanto, i chiamanti dell'API Service Control sono in genere applicazioni server. Di seguito sono riportati i 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 tuo servizio gestito.
  • Se il tuo server riceve errori 429 dall'API Service Control, deve restituire errori 429 ai suoi client.
  • Se il tuo server non riesce ad accedere all'API Service Control, può scegliere di eseguire un fail-open (ignorare l'errore) o un fail-close (restituire 503 al client).
  • Se il tuo server riceve errori 500 dall'API Service Control, deve restituire l'errore 500 ai suoi client. Questi errori in genere indicano bug all'interno dell'API Service Control.
  • Se il tuo server riceve altri errori dall'API Service Control, deve restituire l'errore 500 ai suoi client. Questi errori in genere indicano bug all'interno del servizio gestito.

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

Per utilizzare un servizio API di Google, devi avere un progetto Google Cloud , attivare il servizio per quel 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 disabilitazione dei servizi.

Come faccio a correggere gli errori di autorizzazione negata?

Questi errori in genere 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 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 minimo tra i nuovi tentativi deve essere di 30 secondi per gli errori di quota 429; 1 secondo per gli errori del 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ù elevata?

Per scoprire come richiedere una quota più elevata per ciascuna delle seguenti API Service Infrastructure, consulta 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 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.