Comienza a usar API Gateway y el Centro de APIs

En este instructivo, se muestra cómo conectar API Gateway con el centro de APIs para habilitar la publicación sin problemas de metadatos de la API desde tu proyecto de API Gateway al centro de APIs.

En este instructivo, usarás la consola de Google Cloud .

Lista de tareas

Usa la siguiente lista de tareas mientras trabajas en el instructivo. Todas las tareas son necesarias para conectar API Gateway con el concentrador de API.

1. Realiza los pasos previos que se describen en Antes de comenzar.

2. Implementa una API en API Gateway.

3. Adjunta tu proyecto de API Gateway al Centro de APIs.

4. Consulta tu API de API Gateway en el concentrador de APIs.

5. Evita que se generen cargos en tu cuenta de Google Cloud. Consulta Cómo realizar una limpieza.

Antes de comenzar

Antes de comenzar, asegúrate de haber completado los siguientes pasos previos:

1. Configura API Gateway en tu proyecto.

2. Configura el centro de APIs en tu proyecto host.

Configura API Gateway en tu proyecto

Para configurar API Gateway en tu proyecto, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página API Gateway.

   Ir a API Gateway

   Nota: Si no planeas conservar los recursos creados durante este instructivo, crea un proyecto nuevo en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

2. API Gateway requiere que habilites los siguientes servicios de Google:

   Nombre	Título
   apigateway.googleapis.com	API de API Gateway
   servicemanagement.googleapis.com	API de Administración de servicios
   servicecontrol.googleapis.com	Service Control API

   Si no habilitaste estos servicios anteriormente para el proyecto que seleccionaste, se te solicitará que lo hagas.

3. Confirma que la facturación esté habilitada para tu proyecto.

   Aprende a habilitar la facturación

Configura el centro de APIs en tu proyecto host

1. Crea o selecciona un proyecto de Google Cloud para usarlo como proyecto host.

   Un proyecto host es un proyecto de tu organización que designas como el proyecto del consumidor para todos los recursos del centro de APIs. Google Cloud Google Cloud Se puede aprovisionar una sola instancia del concentrador de APIs por proyecto host.

   Para proporcionar un descubrimiento centralizado de las APIs en todas tus instancias de API Gateway, te recomendamos que uses un proyecto host dedicado para la instancia del concentrador de APIs y que adjuntes varios proyectos de API Gateway, denominados proyectos de tiempo de ejecución, a la instancia del concentrador de APIs.

   Si ya se aprovisionó una instancia del centro de APIs en tu organización o carpeta de Google Cloud , te recomendamos que omitas este paso y vincules tu proyecto de API Gateway a la instancia existente del centro de APIs.

2. Otorga los roles de Identity and Access Management (IAM) necesarios para conectar API Gateway con API Hub.

3. Aprovisiona el centro de APIs en tu proyecto host.

Implementa una API en API Gateway

Completa la guía de inicio rápido de API Gateway para implementar un servicio de Cloud Run de "Hola mundo" y crear una puerta de enlace que apunte a ese servicio.

Por ejemplo, la API de helloworld se implementa en la API de helloworld-gateway de API Gateway, como se muestra en la página Gateways de la Google Cloud consola.

Conecta tu proyecto de API Gateway al centro de API

Para conectar tu proyecto de API Gateway al centro de APIs, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Concentrador de APIs.

   Ir al centro de APIs

2. En el menú desplegable, selecciona tu proyecto host del concentrador de APIs.
3. Haz clic en Configuración en el menú de navegación de la izquierda para abrir la página Configuración.
4. Ve a la pestaña Asociaciones del proyecto.
5. Haz clic en Attach runtime project.
   Se mostrará el panel Select a resource.
6. Haz clic en el proyecto Google Cloud en el que se aprovisionó API Gateway.
7. En el panel Configuración de asociación del proyecto, selecciona API Gateway y cualquier otro recurso de API que desees importar automáticamente.
8. Haz clic en Guardar.

Tu proyecto de entorno de ejecución se adjunta y se muestra en la lista de proyectos de entorno de ejecución adjuntos en la consola de Google Cloud .

Por ejemplo:

Para habilitar la transferencia de datos en tiempo real, el Centro de APIs crea una instancia de complemento de API Gateway para el proyecto de entorno de ejecución conectado cuando seleccionas importar recursos de API Gateway. Puedes ver esta instancia del complemento en la columna Complementos asociados de la página Asociaciones del proyecto.

Visualiza tu API de API Gateway en el concentrador de APIs

Para ver tu API de API Gateway en el centro de APIs, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página APIs en el Centro de APIs.

   Ir al centro de APIs

2. Ubica la API de "Hello World" que implementaste en API Gateway.

   Si es necesario, selecciona Puerta de enlace: API Gateway en el menú desplegable Filtro para mostrar solo las APIs de API Gateway.

   Por ejemplo:

   

3. Haz clic en la API para ver más detalles, incluidos los metadatos de la API.

Realiza una limpieza

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en este instructivo, puedes hacer lo siguiente:

• Cómo borrar tu puerta de enlace
• Borra tu API

Como alternativa, también puedes borrar los Google Cloud proyectos que se usaron para este instructivo.

¿Qué sigue?

• Obtén más información sobre API Gateway.
• Obtén más información para centralizar tus APIs con el Centro de APIs