Implementa una API en una puerta de enlace

En esta página, se describe cómo implementar una API en API Gateway.

Requisitos previos

Antes de implementar una API en API Gateway, asegúrate de hacer lo siguiente:

Requisitos de ID de Gateway

Muchos de los comandos de gcloud CLI que se muestran a continuación requieren que especifiques el ID de la puerta de enlace, en el formato: GATEWAY_ID. API Gateway aplica los siguientes requisitos para el ID de la puerta de enlace:

  • Debe tener una longitud máxima de 49 caracteres.
  • Debe contener solo letras en minúscula, números o guiones.
  • No debe comenzar con un guion.
  • No debe contener un guion bajo.

Define el extremo de la configuración de API implementada

Cuando implementas una configuración de API en una puerta de enlace, API Gateway crea una URL única para la puerta de enlace en el dominio gateway.dev. Luego, tus clientes de API usan una URL con el siguiente formato para acceder a la configuración de API implementada:

https://GATEWAY_ID-HASH.REGION_CODE.gateway.dev

donde GATEWAY_ID es el nombre de la puerta de enlace, HASH es el código hash único que se generó cuando se implementó la API, y REGION_CODE es el código de la ubicación de Cloud en la que implementaste la puerta de enlace.

Por ejemplo:

https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev

Implementa una API en una puerta de enlace

Para implementar una API en una puerta de enlace, haz lo siguiente:

Google Cloud Consola de

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

    Ir a API Gateway

  2. Haz clic en Crear puerta de enlace.

    Se mostrará la página Crear puerta de enlace.

  3. En Seleccionar una API, selecciona Crear una API nueva en el campo Seleccionar una API.
  4. En el campo Nombre visible, ingresa el nombre visible de la API.
  5. En el campo ID de API, ingresa el ID de la API. Consulta los requisitos de ID de API para obtener instrucciones sobre la asignación de nombres de API.
  6. (Opcional) Agrega etiquetas para tu API.
  7. En la sección Configuración de API, selecciona Crear una nueva configuración de API en el campo Seleccionar una configuración.
  8. En el campo Subir una especificación de API, sube un archivo .yaml o .json. Consulta los formatos de archivo OpenAPI 2.0 y OpenAPI 3.x para la definición de la API.
  9. En el campo Nombre visible, ingresa el nombre visible de la configuración de la API.
  10. En la lista Seleccionar una cuenta de servicio, selecciona la cuenta de servicio requerida. API Gateway usará esta cuenta de servicio como su identidad.
  11. (Opcional) Agrega etiquetas para la configuración de tu API.
  12. En la sección Detalles de la puerta de enlace, ingresa un nombre visible para tu puerta de enlace.
  13. En el campo Ubicación, selecciona la Google Cloud región en la que deseas implementar tu puerta de enlace.
  14. (Opcional) Agrega etiquetas para tu API Gateway.
  15. Haz clic en Crear puerta de enlace.

    16. La API recién creada está visible en la página principal de API Gateway.

Google Cloud CLI

  1. Valida el ID del proyecto que muestra el siguiente comando para asegurarte de que la puerta de enlace no se cree en el proyecto equivocado.

    gcloud config list project

    Si necesitas cambiar el proyecto predeterminado, ejecuta el siguiente comando y reemplaza PROJECT_ID por el Google Cloud ID del proyecto en el que quieres crear el servicio:

    gcloud config set project PROJECT_ID

  2. Consulta la ayuda para el comando gateway create:

    gcloud api-gateway gateways create --help

  3. Ejecuta el siguiente comando para implementar la configuración de la API en la puerta de enlace:

    gcloud api-gateway gateways create GATEWAY_ID \
 --api=API_ID --api-config=CONFIG_ID \
 --location=GCP_REGION

    Donde:

    • GATEWAY_ID especifica el ID de la puerta de enlace nueva. Si la puerta de enlace aún no existe, este comando la creará.
    • API_ID especifica el ID de la API de API Gateway asociada con esta puerta de enlace.
    • CONFIG_ID especifica el ID de la configuración de la API implementada en la puerta de enlace. Debes especificar una configuración de API cuando creas una puerta de enlace.
    • GCP_REGION especifica la ubicación de Cloud para la puerta de enlace implementada.

    Mientras se crea la puerta de enlace, la gcloud CLI envía información a la terminal.

  4. Si la operación se completa correctamente, puedes usar el siguiente comando para ver los detalles de la puerta de enlace:

    gcloud api-gateway gateways describe GATEWAY_ID \
 --location=GCP_REGION

    Este comando muestra lo siguiente:

    apiConfig: projects/PROJECT_ID/locations/global/apis/API_ID/configs/CONFIG_ID
createTime: '2020-02-05T13:44:12.997862831Z'
defaultHostname: my-gateway-a12bcd345e67f89g0h.uc.gateway.dev
displayName: GATEWAY_ID
name: projects/PROJECT_ID/locations/GCP_REGION/gateways/GATEWAY_ID
serviceAccount:
 email: gateway-111111@222222-tp.iam.gserviceaccount.com
state: ACTIVE
updateTime: '2020-02-05T13:45:00.844705087Z'

    Ten en cuenta el valor de la propiedad defaultHostname. Esta es la parte del nombre de host de la URL de la puerta de enlace. Para acceder a una configuración de API implementada en esta puerta de enlace, usa una URL con el siguiente formato:

    https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev

La gcloud CLI toma muchas opciones, incluidas las que se describen en la referencia de gcloud. Además, para API Gateway, puedes configurar las siguientes opciones cuando creas una puerta de enlace:

  • --async: Muestra el control a la terminal de inmediato, sin esperar a que se complete la operación.
  • --display-name=NAME: Especifica el nombre visible de la puerta de enlace, es decir, el nombre que se muestra en la IU. No uses espacios en el nombre. En su lugar, usa guiones y guiones bajos. El valor predeterminado es GATEWAY_ID.
  • --labels=KEY1=VALUE1,KEY2=VALUE2,...: Especifica las etiquetas asociadas con la puerta de enlace.

Enumera las puertas de enlace

En esta sección, se explica cómo ver una lista de todas las puertas de enlace de API implementadas en tu Google Cloud proyecto.

Google Cloud Consola de

En la Google Cloud consola de, ve a la página API Gateway > Puertas de enlace.

Ir a Puertas de enlace

Google Cloud CLI

Para enumerar las puertas de enlace de un proyecto específico, haz lo siguiente:

gcloud api-gateway gateways list

Este comando muestra un resultado con el siguiente formato:

GATEWAY_ID        LOCATION       DISPLAY_NAME     STATE     CREATE_TIME          UPDATE_TIME
my-gateway        us-central1    my-gateway       ACTIVE    2021-01-07T00:04:19  2022-05-21T00:33:46

Para enumerar las puertas de enlace de un proyecto y una región específicos, haz lo siguiente:

gcloud api-gateway gateways list --location=GCP_REGION

Usa una expresión filter para enumerar las puertas de enlace asociadas con una API específica:

gcloud api-gateway gateways list \
--filter="apiConfig:projects/PROJECT_ID/locations/global/apis/API_ID/*" \

O usa este filter para enumerar las puertas de enlace de una configuración de API específica:

gcloud api-gateway gateways list \
--filter="apiConfig:projects/PROJECT_ID/locations/global/apis/API_ID/configs/CONFIG_ID" \
--project=PROJECT_ID

Usa la región y los IDs de la puerta de enlace para obtener información detallada sobre la puerta de enlace, incluida la identidad de la configuración de la API implementada en la puerta de enlace:

gcloud api-gateway gateways describe GATEWAY_ID \
--location=GCP_REGION

Actualiza una puerta de enlace

Actualiza una puerta de enlace para hacer lo siguiente:

  • Implementar una configuración de API diferente en la puerta de enlace
  • Actualizar el nombre visible

  • Actualizar las etiquetas

Google Cloud Consola de

Consulta los siguientes pasos para actualizar los detalles de API Gateway:

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

    Ir a API Gateway

  2. Haz clic en la API requerida.
  3. Haz clic en la pestaña Puertas de enlace.
  4. Haz clic en la puerta de enlace requerida.
  5. Haz clic en edit Editar.
  6. Edita el Nombre visible o las Etiquetas.
  7. Selecciona la Configuración de API requerida o haz clic en Crear una nueva configuración de API y crea la configuración como se muestra aquí.
  8. Haz clic en Actualizar.
  9. Haz clic en para volver a la página de la lista de puertas de enlace.
  10. En la página de la lista de puertas de enlace, puedes ver la puerta de enlace actualizada.

Google Cloud CLI

Usa el siguiente comando de gcloud CLI para actualizar una puerta de enlace existente, en la que UPDATE_OPTIONS se reemplaza por la marca y el valor de la opción de la puerta de enlace que deseas actualizar:

gcloud api-gateway gateways update GATEWAY_ID \
UPDATE_OPTIONS --api=API_ID --location=GCP_REGION

Por ejemplo, para actualizar la configuración de la API implementada en la puerta de enlace, haz lo siguiente:

gcloud api-gateway gateways update GATEWAY_ID \
--api-config=NEW_CONFIG_ID --api=API_ID --location=GCP_REGION

donde NEW_CONFIG_ID especifica la nueva configuración de la API que se implementará en la puerta de enlace.

Para obtener una lista completa de las marcas y los argumentos de actualización disponibles, consulta la referencia de gcloud api-gateway gateways update o usa el siguiente comando para ver todas las opciones de actualización:

gcloud api-gateway gateways update --help

Borra una puerta de enlace

En esta sección, se describe cómo borrar una API Gateway existente. Sigue estos pasos para quitar de forma permanente una puerta de enlace y su configuración asociada de tu Google Cloud proyecto.

Google Cloud Consola de

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

    Ir a Puertas de enlace

  2. Haz clic en Más y, luego, en Borrar para borrar la API Gateway elegida.

Google Cloud CLI

Usa el siguiente comando de gcloud CLI para borrar una puerta de enlace existente:

gcloud api-gateway gateways delete GATEWAY_ID \
--location=GCP_REGION

¿Qué sigue?