Get started with connectors

This page applies to Apigee and Apigee hybrid.

View Apigee Edge documentation.

This tutorial shows you how to use Application Integration and connectors to create a sample integration that triggers the publication of a Cloud Pub/Sub message. The tutorial assumes that you have a working knowledge of Application Integration.

In this example, calling an API endpoint triggers the publication of a message to a Cloud Pub/Sub topic. The steps below describe how to configure the API trigger and Pub/Sub connection required to run a successful integration.

Before you begin

Before beginning this tutorial, confirm your Google Cloud login credentials and organization details. This information is required to access connectors UI. Your Apigee credentials are required to access the connectors task within the Application Integration designer. Additional prerequisite steps are described below:

• Before creating a connection for the first time, complete the following steps:

  Note: These steps are only required if you are enabling the Application Integration and Connectors add-ons for the first time for use with Apigee.
  1. Create a new Apigee instance. New Apigee instances can be provisioned with the Provisioning UI.

     For the list of regions supporting connectors, see Supported connector regions.

  2. Confirm that the Application Integration and connectors features are entitled to your Apigee subscription.
  3. Enable the Application Integration and connectors features using the following command:

     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}}}'

     Warning: When you run an add-on command, it overwrites any existing add-ons. Therefore, if you have any existing add-ons, include them in the add-on command. Otherwise, the command to enable Application Integration and connectors will disable all other add-ons in your existing organization. And if an add-on is disabled, Apigee deletes all configurations of the add-on (feature). For example, if you disable the Integrations add-on, all integrations are deleted.
  4. If you don't have a service account, create a service account.

     A service account is a special type of Google account intended to represent a non-human user that needs to authenticate and be authorized to access data in Google APIs. If you don't have a service account, you must create a service account. For more information, see Creating a service account.

Enable required services

Connectors requires that you enable the following Google services:

Name	Title
apigee.googleapis.com	Apigee API
secretmanager.googleapis.com	Secret Manager API
connectors.googleapis.com	Connectors API

If these services have not been enabled for your project previously, you are prompted to enable them when creating the connection in the Create Connection page.

To understand how to enable services, see Enabling services.

What's next

• Learn how to create and use a Pub/Sub connection in your integration.
• See the list of supported connectors.
• Learn how to create and manage connections.