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:

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