Acerca de Cloud Endpoints

Endpoints es un sistema de gestión de APIs distribuido. Ofrece una consola de APIs, alojamiento, registro, monitorización y otras funciones para ayudarte a crear, compartir, mantener y proteger tus APIs. En esta página se ofrece una descripción general de Cloud Endpoints para gRPC. Para obtener información sobre otros tipos de frameworks de API compatibles con Endpoints, consulta todos los documentos de Endpoints.

Endpoints se puede usar con el proxy de servicios extensible (ESP) distribuido o con el proxy de servicios extensible V2 (ESPv2). Cada proxy ofrece asistencia para las plataformas que se describen a continuación:

  • Entorno flexible de App Engine (solo ESP)
  • Google Kubernetes Engine (ESP o ESPv2)
  • Compute Engine (ESP o ESPv2)
  • Kubernetes (ESP o ESPv2)
  • Entorno estándar de App Engine (solo ESPv2)
  • Funciones de Cloud Run (solo ESPv2)
  • Cloud Run (solo ESPv2)
  • Servicio de Knative (solo ESPv2)

Endpoints con ESP

Endpoints usa el proxy de servicio extensible (ESP) distribuido para ofrecer una latencia baja y un rendimiento alto al servir incluso las APIs más exigentes. ESP es un proxy de servicio basado en NGINX, por lo que puedes tener la certeza de que se escalará según sea necesario para gestionar las solicitudes simultáneas a tu API. ESP se ejecuta en su propio contenedor Docker para mejorar el aislamiento y la escalabilidad, y se distribuye en Container Registry. Puedes usarlo con:

Endpoints con ESPv2

ESPv2 es un proxy escalable de alto rendimiento basado en Envoy que se ejecuta delante de un backend de API OpenAPI o gRPC. ESPv2 admite la versión 2 de las especificaciones de OpenAPI y gRPC. Puedes usarlo con:

Funciones de gestión de APIs de Endpoints

Tanto si usas Endpoints con ESP como con ESPv2, te ofrece una serie de funciones de gestión de APIs importantes que te permiten desarrollar, monitorizar y controlar el acceso a tus APIs.

Registros y métricas

Endpoints usa Infraestructura de servicios para gestionar las APIs y registrar métricas y registros. La mayoría de las Google Cloud APIs usan esta misma infraestructura. Puedes gestionar y monitorizar tus APIs en la página Servicios de Endpoints de la Google Cloud consola.

Alojamiento de APIs

Endpoints está optimizado para el entorno de contenedores Docker. Puedes alojar tu API en cualquier lugar donde se admita Docker, siempre que tenga acceso a Internet paraGoogle Cloud.

Desarrollar una API gRPC con Endpoints

  1. Define un servicio de API gRPC con buffers de protocolo e impleméntalo en cualquier lenguaje compatible con gRPC.

  2. Escribe la configuración de tu servicio de API gRPC para Endpoints.

  3. Genera la configuración de la API de tiempo de ejecución de tu API y despliégala en Service Management.

  4. Despliega tu servidor de API.

Puedes consultar más información sobre el uso de gRPC con Endpoints en Endpoints para APIs gRPC y en los tutoriales correspondientes.

Controlar el acceso a la API

Endpoints te permite configurar tu API para que requiera una clave de API para cualquier llamada y valida la clave de API. También puedes usar la Google Cloud consola para compartir tu API con otros desarrolladores para que puedan habilitarla y generar claves de API para llamarla.

Autenticar usuarios de la API

En la mayoría de las llamadas a la API, hay un usuario al otro lado. Aunque las claves de API indican qué aplicación está haciendo una llamada a tu API, el proceso de autenticación determina qué usuario está usando esa aplicación.

Ten en cuenta que tu servidor de API debe decidir qué puede hacer el usuario autenticado con tu API. Para obtener más información, consulta la Google Cloud guía de autenticación.

Siguientes pasos

  • Familiarízate con los pasos de implementación y consulta las funciones de Endpoints en acción con la guía de inicio rápido de Endpoints, que usa secuencias de comandos para implementar una API de ejemplo en un backend flexible de App Engine.

  • Para obtener más información sobre cómo usar Endpoints, consulta uno de los tutoriales.