Questa pagina fornisce informazioni generali per la risoluzione dei problemi e link ad altre pagine per ulteriori informazioni.
Errori durante il deployment della configurazione di Cloud Endpoints
Se hai ricevuto un messaggio di errore dal comando gcloud endpoints services deploy
, consulta
Risoluzione dei problemi di implementazione della configurazione degli endpoint
per informazioni sulla risoluzione dell'errore.
Errori durante il deployment del backend dell'API
Il deployment dell'API e di Extensible Service Proxy (ESP) in un Il backend di Google Cloud dipende dalla piattaforma. Per ulteriori informazioni, consulta le seguenti guide alla risoluzione dei problemi:
Errori di risposta
Quando invii una richiesta all'API e ricevi una risposta di errore, consulta Risoluzione dei problemi relativi alle risposte per informazioni sulla risoluzione dell'errore.
Verifica dei servizi richiesti
Controllo dei servizi richiesti in corso...
Come minimo, Endpoints ed ESP richiedono seguenti servizi Google da attivare:Nome | Titolo |
---|---|
servicemanagement.googleapis.com |
API Service Management |
servicecontrol.googleapis.com |
API Service Control |
endpoints.googleapis.com |
Google Cloud Endpoints |
Nella maggior parte dei casi, il comando gcloud endpoints services deploy
attiva questi servizi obbligatori. Tuttavia, il comando gcloud
viene completato correttamente,
non abilita i servizi richiesti nelle seguenti circostanze:
Se hai utilizzato un'applicazione di terze parti, come Terraform, includono questi servizi.
Hai eseguito il deployment della configurazione di Endpoints in una Progetto Google Cloud in cui questi servizi sono stati espressamente disabilitati.
Utilizza il comando seguente per confermare che i servizi richiesti siano abilitati:
gcloud services list
Se non vedi elencati i servizi richiesti, abilitali:
gcloud services enable servicemanagement.googleapis.comgcloud services enable servicecontrol.googleapis.com
gcloud services enable endpoints.googleapis.com
Abilita anche il servizio Endpoints:
gcloud services enable ENDPOINTS_SERVICE_NAME
Per determinare ENDPOINTS_SERVICE_NAME, puoi:
Dopo aver eseguito il deployment della configurazione di Endpoints, vai alla pagina Endpoint nella console Cloud. L'elenco dei possibili ENDPOINTS_SERVICE_NAME è riportato nella colonna Nome servizio.
Per OpenAPI, ENDPOINTS_SERVICE_NAME è il valore specificato nel campo
host
della specifica OpenAPI. Per gRPC, ENDPOINTS_SERVICE_NAME è il valore specificato nel camponame
della configurazione degli endpoint gRPC.
Per ulteriori informazioni sui comandi gcloud
, consulta
Servizi gcloud
.
Controllo delle autorizzazioni richieste
L'istanza che esegue Extensible Service Proxy richiede le autorizzazioni per chiamare Service Management e ServiceControl.
Per ESP di cui è stato eseguito il deployment in Cloud Run, consulta il tutorial sulla creazione di una nuova immagine ESPv2 in Cloud Run per maggiori dettagli.
Per ESP di cui è stato eseguito il deployment su Compute Engine, vedi Verificare le autorizzazioni richieste in Compute Engine per maggiori dettagli.
Per ESP di cui è stato eseguito il deployment su GKE, consulta il tutorial per verificare le autorizzazioni richieste in GKE per maggiori dettagli.
Controllo delle informazioni di debug in corso...
L'esecuzione di Google Cloud CLI con la modalità di verbosità di debug è utile per il debugging.
gcloud --verbosity=debug COMMAND
Questo comando consente a Google Cloud CLI di stampare un log dettagliato dell'errore. A seconda del comando da eseguire, l'output può includere le informazioni di risposta dal server.
Attivazione di un servizio
Puoi verificare se un servizio è attivo utilizzando gcloud
.
gcloud services list
Per visualizzare la configurazione di un determinato servizio, utilizza il seguente comando:
gcloud endpoints services describe SERVICE_NAME
Il proxy OAuth ha esito negativo, ma le richieste sono state superate
Assicurati che sia presente una sezione authentication
con la tua definizione OAuth
del file di configurazione dell'API gRPC. Un esempio di file di configurazione è
disponibili nel
Esempio di Bookstore su GitHub.