Guías prácticas

Configurar y desplegar una API

• Configurar Cloud Endpoints

  Explica cómo preparar el documento de OpenAPI para implementarlo en Endpoints.

• Desplegar la configuración de Endpoints

  Describe cómo implementar un documento de OpenAPI en Endpoints.

• Desplegar el backend de la API

  Explica cómo desplegar el código de backend de tu API y el proxy de servicio extensible (ESP).

• Desplegar en Kubernetes

  Muestra cómo configurar y desplegar Endpoints en Kubernetes.

• Ejecutar el ESP localmente o en otra plataforma

  Muestra cómo configurar una instancia del ESP en una máquina local o en otro proveedor de servicios en la nube.

• Comparar archivos de configuración

  Describe la pestaña Historial de implementaciones de la página Endpoints > Services (Endpoints > Servicios) de la consola de Google Cloud y cómo comparar una configuración de servicio implementada con la versión anterior.

• Obtener el nombre del servicio y el ID de configuración

  Describe cómo obtener el nombre y el ID de configuración de un servicio gestionado.

Solución de problemas y monitorización

• Información general sobre la solución de problemas

  Proporciona información general para solucionar problemas y enlaces a otras páginas para obtener más información.

• Solucionar problemas de despliegue de la configuración de Endpoints

  Describe algunos errores que pueden producirse al desplegar la configuración de Endpoints y cómo solucionarlos.

• Solucionar problemas de errores de respuesta

  Describe cómo solucionar los errores que recibes en una respuesta de una solicitud a tu API.

• Solucionar problemas de despliegue en el entorno flexible de App Engine

  Proporciona técnicas para solucionar problemas de despliegues de Endpoints en el entorno flexible de App Engine.

• Solucionar problemas del despliegue de Compute Engine

  Proporciona técnicas para solucionar problemas de despliegues de Endpoints en Compute Engine.

• Solucionar problemas de despliegue de GKE

  Proporciona técnicas para solucionar problemas de implementaciones de Endpoints en GKE.

• Solucionar problemas de validación de JWT

  Proporciona información para solucionar problemas si la validación de JWT falla y se devuelve un error en la respuesta al cliente.

• Supervisar la API

  Describe cómo monitorizar el estado de las APIs mediante los registros y las métricas que Endpoints mantiene automáticamente.

• Rastrear tu API

  Explica la frecuencia de muestreo de las trazas, cómo estimar el coste de Cloud Trace, cómo ver las trazas en la Google Cloud consola y cómo inhabilitar el muestreo de trazas.

DNS y SSL

• Verificar un nombre de dominio

  Muestra cómo verificar la propiedad de un nombre de dominio que sirve una API de Endpoints.

• Servir una API desde tu nombre de dominio

  Muestra cómo configurar tu proyecto para que responda a solicitudes de la API.

• Configurar DNS en el dominio cloud.goog

  Muestra cómo configurar el DNS para los servicios de Endpoints que usan el dominio cloud.goog, que es propiedad de Google y que gestiona Google.

• Servir varias APIs desde un dominio

  Muestra cómo ejecutar varias APIs independientes en tu propio dominio.

• Habilitar SSL con ESP

  Muestra cómo habilitar un puerto SSL para el servicio de Endpoints implementado mediante ESP.

• Habilitar SSL con ESPv2

  Muestra cómo habilitar un puerto SSL para el servicio de Endpoints desplegado mediante ESPv2.

Autenticación y claves de API

• Elegir un método de autenticación

  Ofrece una descripción general y ejemplos de casos prácticos de cada método de autenticación admitido.

• Por qué y cuándo utilizar claves de API

  Proporciona información general sobre las claves de API y cuándo usarlas.

• Autenticar usuarios mediante Firebase

  Muestra cómo configurar el documento de OpenAPI para que ESP valide las solicitudes entrantes de los clientes que usan Firebase para autenticar a los usuarios.

• Autenticar usuarios mediante Auth0

  Muestra cómo configurar el documento de OpenAPI para que ESP valide las solicitudes entrantes de los clientes que usan Auth0 para autenticar a los usuarios.

• Autenticar usuarios mediante tokens de ID de Google

  Muestra cómo configurar el documento de OpenAPI para que ESP valide las solicitudes entrantes de los clientes mediante tokens de ID de Google para autenticar a los usuarios.

• Autenticar usuarios mediante un método personalizado

  Muestra cómo configurar el documento de OpenAPI para que ESP valide las solicitudes entrantes de los clientes mediante un proveedor personalizado para autenticar a los usuarios.

• Autenticación entre servicios

  Muestra cómo autenticar llamadas entre servicios.

• Restringir el acceso con claves de API

  Muestra cómo evitar que aplicaciones y servicios cliente no autorizados accedan a tu API.

Gestionar el acceso a APIs

• Información general sobre el acceso a la API

  Describe las opciones de control de acceso a la API que tienes disponibles en Endpoints.

• Controlar quién puede habilitar tu API

  Muestra cómo controlar quién puede habilitar tu API en sus propios proyectos. Google Cloud

• Habilitar una API en tu Google Cloud proyecto

  Muestra cómo habilitar una API en un Google Cloud proyecto.

• Conceder y revocar el acceso a la API

  Muestra cómo conceder diferentes niveles de acceso para que otros miembros del equipo puedan ayudar a gestionar la API.

Gestión del ciclo de vida de las APIs

• Información general sobre la gestión del ciclo de vida de las APIs

  Describe las funciones de control de versiones de la API Endpoints y proporciona prácticas recomendadas para controlar las versiones y las fases de tu API Endpoints.

• Eliminar una API y sus instancias

  Muestra cómo eliminar una API y apagar las instancias que la ejecutan para evitar costes innecesarios.

• Restaurar un servicio gestionado

  Muestra cómo restaurar un servicio gestionado en caso de que se elimine por error.

Limitar las solicitudes a APIs (beta)

• Información sobre las cuotas

  Ofrece un resumen de las funciones clave que proporcionan las cuotas.

• Configurar cuotas

  Describe cómo configurar cuotas para tu API.

• Anular el límite de cuota predeterminado

  Describe cómo definir un límite de cuota diferente para un proyecto de consumidor específico.

Personalizar ESP

• Usar un nginx.conf personalizado en Google Kubernetes Engine

  Describe cómo crear un archivo nginx.conf personalizado para desplegar ESP en GKE.

• Crear un nginx.conf personalizado para admitir CORS

  Muestra ejemplos de cómo se escriben las opciones de CORS de ESP en nginx.conf como punto de partida si necesitas personalizar la compatibilidad con CORS en ESP.

Otras guías prácticas de Endpoints

• Migrar a ESPv2

• Guías prácticas de Cloud Endpoints Frameworks para el entorno estándar de App Engine

• Guías prácticas de Cloud Endpoints para gRPC