Conecta API Gateway con el centro de APIs

En esta página, se describe cómo conectar API Gateway con el concentrador de APIs de Apigee para que puedas ver tus APIs y centralizar su administración.

Descripción general

Como administrador de API Gateway, para conectar API Gateway con el centro de API, deberás seguir estos pasos:

  1. Aprovisiona el concentrador de API
  2. Cómo adjuntar tu proyecto de API Gateway al centro de APIs

Antes de comenzar: Otorga roles

Asegúrate de tener los roles de Identity and Access Management (IAM) adecuados para conectar API Gateway con el centro de APIs.

En el proyecto en el que aprovisionarás el concentrador de APIs, haz lo siguiente:

  • Otorga roles para el aprovisionamiento, como se describe en Antes de comenzar en los pasos de aprovisionamiento del concentrador de APIs.

En los proyectos de API Gateway que conectarás al centro de APIs, haz lo siguiente:

Aprovisiona el concentrador de API

Antes de conectar API Gateway con API Hub, deberás aprovisionar API Hub en tu proyecto host. Un proyecto host es un proyecto de tu organización Google Cloud que designas como el proyecto del consumidor para todos los recursos del centro de APIs. 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.

Para aprovisionar el centro de APIs en tu proyecto host, haz una de las siguientes acciones:

  • En la consola de Google Cloud , ve a la página Centro de APIs, selecciona el proyecto Google Cloud que se usará como proyecto host y haz clic en Configurar el centro de APIs.

    Puedes acceder a esta página desde las páginas de API Gateway de la siguiente manera:

    • Haz clic en Comenzar en el banner del centro de APIs que se encuentra en la parte superior de cualquiera de las páginas de API Gateway.
    • Haz clic en Comienza a usar el concentrador de APIs en la parte superior de la página de APIs.

    Luego, sigue los pasos detallados de aprovisionamiento que se describen en Aprovisiona el concentrador de API en la consola de Cloud.

  • Usa la línea de comandos o Terraform.

Conecta tu proyecto de API Gateway al centro de APIs

Conecta tu proyecto de API Gateway al Centro de APIs.

Consola deGoogle Cloud

Para conectar un 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. Haz clic en Configuración en el menú de navegación de la izquierda para abrir la página Configuración.
  3. Ve a la pestaña Asociaciones del proyecto.
  4. Si tu proyecto de API Gateway no aparece en la lista de proyectos de entorno de ejecución conectados, haz lo siguiente:
    1. Haz clic en Attach runtime project.
      Se mostrará el panel Select a resource.
    2. Haz clic en el proyecto Google Cloud en el que se aprovisionó API Gateway.
    3. En el panel Configuración de asociación del proyecto, selecciona API Gateway y cualquier otro recurso de API que desees importar automáticamente.
    4. Haz clic en Guardar.
  5. Si tu proyecto de API Gateway ya está en la lista de proyectos de entorno de ejecución conectados, haz lo siguiente:
    1. Haz clic en Edit settings en la fila asociada con el proyecto de tiempo de ejecución de API Gateway.
    2. En el panel Configuración de asociación del proyecto, selecciona API Gateway y cualquier otro recurso de API que desees importar automáticamente.
    3. Haz clic en Guardar.

REST

Para conectar tu proyecto de API Gateway al centro de APIs, usa las APIs de Create runtime project attachments y Create plugin instance.

Por ejemplo, para crear la vinculación del proyecto de entorno de ejecución, haz lo siguiente:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT_ID/locations/HUB_LOCATION/runtimeProjectAttachments?runtimeProjectAttachmentId=RUNTIME_PROJECT_ID" \
  -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{"runtimeProject":"projects/RUNTIME_PROJECT_ID"}'

Reemplaza lo siguiente:

  • HUB_PROJECT_ID: el nombre de tu proyecto host del concentrador de APIs. El proyecto host se seleccionó cuando se aprovisionó el concentrador de APIs.
  • HUB_LOCATION: La ubicación del proyecto host. La ubicación se eligió cuando se aprovisionó el concentrador de APIs.
  • RUNTIME_PROJECT_ID: Es el nombre de tu proyecto de tiempo de ejecución de API Gateway.

Si la operación se realiza correctamente, se devuelve un objeto JSON de RuntimeProjectAttachment.

Luego, para crear la instancia del complemento de API Gateway, haz lo siguiente:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT_ID/locations/HUB_LOCATION/plugins/PLUGIN_TYPE/instances" \
  -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "API Gateway Plugin Instance",
    "sourceProjectId": "RUNTIME_PROJECT_ID",
    "actions": [
      {
        "actionId": "sync-metadata"
      }
    ]
  }'

Reemplaza lo siguiente:

  • HUB_PROJECT_ID: el nombre de tu proyecto host del concentrador de APIs. El proyecto host se seleccionó cuando se aprovisionó el concentrador de APIs.
  • HUB_LOCATION: La ubicación del proyecto host. La ubicación se eligió cuando se aprovisionó el concentrador de APIs.
  • PLUGIN_TYPE: Tipo de complemento. Se establece en system-api-gateway.
  • RUNTIME_PROJECT_ID: Es el nombre de tu proyecto de tiempo de ejecución de API Gateway.

Si la operación se realiza correctamente, se devuelve un objeto JSON de Operation.