Premiers pas avec les connecteurs

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Ce tutoriel explique comment utiliser Apigee Integration et les connecteurs pour créer un exemple d'intégration qui déclenche la publication d'un message Cloud Pub/Sub. Dans ce tutoriel, nous partons du principe que vous disposez de connaissances de base sur Apigee Integration.

Dans cet exemple, l'appel d'un point de terminaison d'API déclenche la publication d'un message dans un sujet Cloud Pub/Sub. Les étapes ci-dessous décrivent comment configurer le déclencheur d'API et la connexion Pub/Sub requis pour réussir l'intégration.

Avant de commencer

Avant de commencer ce tutoriel, confirmez vos identifiants de connexion Google Cloud et vos informations d'organisation. Ces informations sont requises pour accéder à l'interface utilisateur des connecteurs. Vos identifiants Apigee sont requis pour accéder à la tâche des connecteurs dans le concepteur Apigee Integration. Les étapes préalables supplémentaires sont décrites ci-dessous :

• Avant de créer une connexion pour la première fois, procédez comme suit :

  Remarque : Ces étapes ne sont requises que si vous activez les modules complémentaires Apigee Integration et Connectors pour la première fois pour une utilisation avec Apigee.
  1. Créez une instance Apigee. Les nouvelles instances Apigee peuvent être provisionnées avec l'interface utilisateur de gestion des comptes.

     Pour obtenir la liste des régions compatibles avec les connecteurs, consultez la section Régions de connecteurs compatibles.

  2. Vérifiez que les fonctionnalités Apigee Integration et les connecteurs sont autorisés à votre abonnement Apigee.
  3. Activez les fonctionnalités Apigee Integration et les connecteurs à l'aide de la commande suivante :

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

     Avertissement : Lorsque vous exécutez une commande de module complémentaire, celle-ci écrase tous les modules complémentaires existants. Par conséquent, si vous disposez de modules complémentaires existants, incluez-les dans la commande complémentaire. Sinon, la commande permettant d'activer Apigee Integration et les connecteurs désactivera tous les autres modules complémentaires de votre organisation existante. Si un module complémentaire est désactivé, Apigee supprime toutes les configurations du module complémentaire (fonctionnalité). Par exemple, si vous désactivez le module complémentaire "Integrations", toutes les intégrations sont supprimées.
  4. Si vous ne disposez pas d'un compte de service, créez-en un.

     Un compte de service est un compte Google spécial destiné à représenter un utilisateur non humain qui doit s'authentifier et obtenir les autorisations permettant d'accéder aux données des API Google. Si vous ne possédez pas de compte de service, vous devez en créer un. Pour plus d'informations, consultez la section Créer un compte de service.

Activer les services requis

Les connecteurs nécessitent l'activation des services Google suivants :

Nom	Titre
apigee.googleapis.com	API Apigee
secretmanager.googleapis.com	API Secret Manager
connectors.googleapis.com	API Connectors

Si ces services n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la création de la connexion sur la page "Créer une connexion".

Pour savoir comment activer des services, consultez la page Activer des services.

Étapes suivantes

• Découvrez comment créer et utiliser une connexion Pub/Sub dans votre intégration.
• Consultez la liste des connecteurs compatibles.
• Découvrez comment créer et gérer des connexions.