Cette page s'applique à Apigee et à Apigee hybrid.
Le hub d'API est compatible avec les déclencheurs Eventarc. En utilisant cette fonctionnalité, vous pouvez déclencher des exécutions en fonction des événements se produisant dans le hub d'API. Par exemple, vous pouvez exécuter un service Cloud Run lorsqu'une API est créée dans le hub d'API.
Ce tutoriel explique comment créer et configurer un déclencheur Eventarc qui exécute un service Cloud Run lorsqu'une API est mise à jour dans API Hub.
Avant de commencer
- Le hub d'API doit être provisionné dans un projet Google Cloud auquel vous avez accès. Consultez la section Provisionner le hub d'API.
Dans la console Google Cloud, sur la page de sélection du projet, sélectionnez le projet dans lequel le hub d'API est provisionné.
Accéder au sélecteur de projet- Vous devez disposer d'un service Cloud Run valide. Vous utiliserez les détails du service Cloud Run pour configurer le déclencheur Eventarc. Il s'agit du service qui sera exécuté lorsque l'événement configuré se produira.
Créer un déclencheur Eventarc
- Dans la console Google Cloud, accédez à la page Déclencheurs d'Eventarc.
- Cliquez sur Créer un déclencheur.
- Saisissez un nom de déclencheur.
Exemple :
cloudrun-trigger-1
- Dans la liste Type de déclencheur, sélectionnez Sources Google.
Cette action filtre les événements envoyés depuis des fournisseurs Google Cloud (directement ou via des entrées Cloud Audit Logs) ou des fournisseurs utilisant des messages Pub/Sub.
- Dans la liste Fournisseur d'événements, sélectionnez API Hub.
- Dans la liste Type d'événement, sélectionnez google.cloud.apihub.v1.updated.
- Dans la liste Type de données de contenu de l'événement, sélectionnez
JSON
ouProtobuf
. - Sélectionnez une Région.
- Si vous le souhaitez, vous pouvez ajouter des filtres pour sélectionner les API qui correspondent à vos critères. Par exemple, si vous filtrez les API par un nom spécifique, l'événement n'est déclenché que si les API correspondant aux critères de filtre sont mises à jour.
- Si vous y êtes invité, accordez les autorisations suivantes :
- Rôle
iam.serviceAccountTokenCreator
pour le compte de service Pub/Sub - Rôle
pubsub.publisher
pour le compte de service Cloud Storage
- Rôle
- Utilisez le compte de service Compute par défaut comme compte de service qui appelle votre service.
- Dans la liste Destination de l'événement, sélectionnez Cloud Run.
- Sélectionnez un service Cloud Run qui doit être exécuté lorsque l'événement
google.cloud.apihub.v1.updated
se produit dans le hub d'API. - Vous pouvez éventuellement saisir le chemin de l'URL du service.
- Cliquez sur Créer.