Información general sobre la solución de problemas

En esta página se proporciona información general para solucionar problemas y enlaces a otras páginas con información adicional.

Errores al desplegar la configuración de Cloud Endpoints

Si has recibido un mensaje de error del comando gcloud endpoints services deploy, consulta el artículo Solucionar problemas de implementación de la configuración de endpoints para obtener información sobre cómo solucionar el error.

Errores al implementar tu backend de API

El despliegue de tu API y del proxy de servicio extensible (ESP) en un backendGoogle Cloud depende de la plataforma. Consulta las siguientes guías para solucionar problemas para obtener más información:

Errores de respuesta

Cuando envíes una solicitud a tu API y recibas una respuesta de error, consulta la sección Solucionar problemas de respuestas de error para obtener información sobre cómo solucionar el error.

Comprobando los servicios necesarios

Comprobando los servicios necesarios

Como mínimo, Endpoints y ESP requieren que los siguientes servicios de Google estén habilitados:
Nombre Título
servicemanagement.googleapis.com API Service Management
servicecontrol.googleapis.com API Service Control

En la mayoría de los casos, el comando gcloud endpoints services deploy habilita estos servicios obligatorios. Sin embargo, el comando gcloud se completa correctamente, pero no habilita los servicios necesarios en las siguientes circunstancias:

  • Si has usado una aplicación de terceros, como Terraform, y no incluyes estos servicios.

  • Has desplegado la configuración de Endpoints en unGoogle Cloud proyecto en el que estos servicios se han inhabilitado explícitamente.

Usa el siguiente comando para confirmar que los servicios necesarios están habilitados:

gcloud services list

Si no ves los servicios necesarios, habilítalos:

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com

También debes habilitar el servicio Endpoints:

gcloud services enable ENDPOINTS_SERVICE_NAME

Para determinar el ENDPOINTS_SERVICE_NAME, puedes hacer lo siguiente:

  • Después de desplegar la configuración de Endpoints, ve a la página Endpoints de la consola de Cloud. La lista de posibles ENDPOINTS_SERVICE_NAME se muestra en la columna Nombre del servicio.

  • En OpenAPI, ENDPOINTS_SERVICE_NAME es el valor que has especificado en el campo host de tu especificación de OpenAPI. En gRPC, ENDPOINTS_SERVICE_NAME es el valor que has especificado en el campo name de tu configuración de endpoints de gRPC.

Para obtener más información sobre los comandos de gcloud, consulta los servicios de gcloud.

Comprobando los permisos necesarios

La instancia que ejecuta Extensible Service Proxy requiere permisos para llamar a Service Management y ServiceControl.

Comprobar la información de depuración

Ejecutar Google Cloud CLI con el nivel de detalle de depuración ayuda a depurar.

gcloud --verbosity=debug COMMAND

Este comando hace que Google Cloud CLI imprima un registro detallado del error. En función del comando que se ejecute, el resultado puede incluir información sobre la solicitud y la respuesta del servidor.

Activación de un servicio

Puedes comprobar si un servicio está habilitado con gcloud.

gcloud services list

Para mostrar la configuración de un servicio concreto, usa el siguiente comando:

gcloud endpoints services describe SERVICE_NAME

Falla el proxy de OAuth, pero las solicitudes se completan

Asegúrate de que haya una sección authentication que tenga tu definición de OAuth en el archivo de configuración de la API gRPC. Puedes consultar un ejemplo de archivo de configuración en el ejemplo de librería en GitHub.

Siguientes pasos