Comenzar a usar conectores

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En este instructivo, se muestra cómo usar Application Integration y conectores para crear una integración de muestra que active la publicación de un mensaje de Cloud Pub/Sub. En el instructivo, se da por sentado que tienes un conocimiento práctico sobre Application Integration.

En este ejemplo, llamar a un extremo de API activa la publicación de un mensaje en un tema de Cloud Pub/Sub. En los siguientes pasos, se describe cómo configurar el activador de API y la conexión de Pub/Sub necesarios para ejecutar una integración exitosa.

Antes de comenzar

Antes de comenzar este instructivo, confirma tus credenciales de acceso de Google Cloud y los detalles de la organización. Se requiere esta información para acceder a la IU de los conectores. Tus credenciales de Apigee son necesarias para acceder a la tarea de conectores dentro del diseñador de Application Integration. A continuación, se describen los pasos de los requisitos adicionales:

• Antes de crear una conexión por primera vez, completa los siguientes pasos:

  Nota: Estos pasos solo son necesarios si habilitas los complementos de Application Integration y conectores por primera vez para usarlos con Apigee.
  1. Crea una nueva instancia de Apigee. Las instancias de Apigee nuevas se pueden aprovisionar con la IU de aprovisionamiento.

     Para obtener la lista de regiones compatibles con los conectores, consulta Regiones de conectores compatibles.

  2. Confirma que las funciones de Application Integration y conectores tengan derecho a tu suscripción a Apigee.
  3. Habilita las funciones de conectores y Application Integration con el siguiente comando:

     curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H \
     "content-type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/PROJECT_ID:setAddons" -XPOST \
     -d '{"addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig": {"enabled": true}}}'

     Advertencia: Cuando ejecutas un comando de complemento, se reemplazan todos los complementos existentes. Por lo tanto, si tienes complementos existentes, inclúyelos en el comando de complementos. De lo contrario, el comando para habilitar Application Integration y los conectores inhabilitará todos los demás complementos en tu organización existente. Si un complemento está inhabilitado, Apigee borra todas las configuraciones del complemento (función). Por ejemplo, si inhabilitas el complemento Integrations, se borran todas las integraciones.
  4. Si no tienes una cuenta de servicio, créala.

     Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano. Estas cuentas deben autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

Habilita los servicios obligatorios

Los conectores requieren que habilites los siguientes servicios de Google:

Nombre	Título
apigee.googleapis.com	API de Apigee
secretmanager.googleapis.com	API de Secret Manager
connectors.googleapis.com	API de conectores

Si estos servicios no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando crees la conexión en la página Crear conexión.

Para comprender cómo habilitar servicios, consulta Habilita servicios.

¿Qué sigue?

• Aprende a crear y usar una conexión de Pub/Sub en tu integración.
• Consulta la lista de conectores compatibles.
• Aprende a crear y administrar conexiones.