This pageapplies toApigee andApigee hybrid.

View Apigee Edge documentation.

This tutorial shows you how to use Application Integration and connectors to create a sample integration thattriggers the publication of a Cloud Pub/Sub message. The tutorial assumes that you have a working knowledge ofApplication 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. Thisinformation 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 connectionfor 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 theProvisioning UI.

     For the list of regions supporting connectors, seeSupported 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, seeCreating 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, seeEnabling services.

What's next

• Learn how tocreate and use a Pub/Sub connection in your integration.
• See the list ofsupported connectors.
• Learn how tocreate and manage connections.