Guías prácticas

Configurar y desplegar una API

• Configurar Cloud Endpoints

  Describe los archivos de configuración necesarios para crear un servicio gRPC gestionado por Endpoints.

• Desplegar la configuración de Endpoints

  Muestra cómo desplegar una configuración de servicio en Endpoints.

• Desplegar el backend de la API

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

• Ejecutar el ESP localmente o en otra plataforma

  Explica cómo configurar y ejecutar el ESP en una máquina local o en otro proveedor de servicios en la nube.

• Transcodificar HTTP/JSON a gRPC

  Muestra cómo asignar solicitudes HTTP/JSON y sus parámetros a métodos gRPC y sus parámetros y tipos de retorno.

• Comparar archivos de configuración

  Describe la pestaña Historial de implementaciones de la página Servicios de endpoints de la consola de Google Cloud y cómo comparar la configuración de un servicio implementado 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

• 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 Endpoints en 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 del JWT falla y se devuelve un error en la respuesta al cliente.

• Supervisar la API

  Muestra cómo ver las métricas y los registros de las APIs en la Google Cloud consola.

• 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 implementado 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 la autenticación, así como los casos en los que deberías plantearte usar claves de API.

• Autenticar usuarios

  Muestra cómo configurar la autenticación de una API gRPC.

• Autenticación entre servicios

  Muestra cómo usar la autenticación entre servicios en un servicio gRPC.

• Restringir el acceso a las APIs con claves de API

  Muestra cómo restringir el acceso a la API a los clientes que tienen una clave de 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 Google Cloud proyectos.

• 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

• Planificar tus Google Cloud proyectos

  Ofrece recomendaciones sobre las convenciones de nomenclatura de los Google Cloud proyectos que puede que tengas que crear además del Google Cloud proyecto de tu backend de producción.

• 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 OpenAPI