Intégration AWS Clean Rooms dans des applications axées sur les événements à l'aide d'Amazon EventBridge

Vous pouvez les AWS Clean Rooms intégrer à des applications pilotées par des événements (EDAs) qui utilisent des événements qui se produisent AWS Clean Rooms pour communiquer entre les composants de l'application et lancer des processus en aval. Pour ce faire, utilisez Amazon EventBridge pour acheminer les événements depuis AWS Clean Rooms d'autres composants logiciels. Amazon EventBridge est un service sans serveur qui utilise des événements pour connecter les composants de l'application entre eux, ce qui vous permet d'intégrer plus facilement des AWS services, par exemple AWS Clean Rooms dans des architectures pilotées par des événements, sans code ni opérations supplémentaires.

Une architecture pilotée par les événements est un style de création de systèmes logiciels faiblement couplés qui fonctionnent ensemble en émettant des événements et en y répondant. Dans ce modèle, un événement représente une modification d'une ressource ou d'un environnement.

Voici comment EventBridge fonctionne avec AWS Clean Rooms :

Comme c'est le cas pour de nombreux AWS services, AWS Clean Rooms génère et envoie des événements au bus d'événements EventBridge par défaut. Un bus d'événements est un routeur qui reçoit des événements et les achemine vers les destinations, ou cibles, que vous spécifiez. Les cibles peuvent inclure d'autres AWS services, des applications personnalisées et des applications partenaires SaaS.

EventBridge achemine les événements conformément aux règles que vous créez sur le bus d'événements. Pour chaque règle, vous spécifiez un filtre, ou un modèle d'événement, afin de sélectionner uniquement les événements souhaités. Chaque fois qu'un événement est envoyé au bus d'événements EventBridge , comparez-le à chaque règle. Si l'événement correspond à la règle, EventBridge achemine l'événement vers la ou les cibles spécifiées.

Supposons, par exemple, que vous souhaitiez savoir chaque fois qu'une nouvelle AWS Clean Rooms collaboration est créée dans votre compte. Vous pouvez créer une règle sur le bus d'événements par défaut. Dans la règle, vous créeriez un modèle d'événement nommant les événements provenant d'AWS Clean RoomsCollaboration Created. Chaque fois que EventBridge je recevais un événement correspondant à ces propriétés, il acheminait l'événement vers le flux de travail spécifié.

AWS Clean Rooms événements

AWS les services peuvent envoyer des événements directement au bus d'événements EventBridge par défaut. En outre, AWS CloudTrail envoie également des événements provenant de nombreux AWS services à EventBridge . Ces événements peuvent inclure des appels d'API, des connexions et des actions à la console, des événements de service et CloudTrail Insights. Pour plus d'informations, consultez les événements AWS de service fournis via AWS CloudTrail dans le guide de EventBridge l'utilisateur.

Pour obtenir la liste complète des AWS Clean Rooms événements envoyés à EventBridge, reportez-vous à la AWS Clean Rooms rubrique correspondante dans la référence EventBridge des événements.

Type de détail de l'événement	Description
Collaboration créée	Collaboration créée
Collaboration mise à jour	Collaboration mise à jour
Adhésion créée	Adhésion créée
Adhésion mise à jour	Adhésion mise à jour
Abonnement supprimé	Abonnement supprimé
Requête protégée soumise	Requête protégée soumise
Requête protégée réussie	Requête protégée réussie
Échec de la requête protégée	Échec de la requête protégée
Expération du délai imparti pour la requête protégée	Expération du délai imparti pour la requête protégée
Job protégé soumis	Job protégé soumis
Job protégé réussi	Job protégé réussi
Echec du Job protégé	Echec du Job protégé
Job protégé annulé	Job protégé annulé

Routage AWS Clean Rooms des événements à l'aide EventBridge

Pour EventBridge acheminer AWS Clean Rooms les événements vers une cible, vous devez créer une règle. Chaque règle contient un modèle d'événement, qui EventBridge correspond à chaque événement reçu sur le bus d'événements. Si les données d'événement correspondent au modèle d'événement spécifié, EventBridge achemine cet événement vers les cibles de la règle.

Pour obtenir des instructions complètes sur la création de règles de bus d'événements, voir Création de règles réagissant aux événements dans le Guide de EventBridge l'utilisateur.

Création de modèles d'événements qui correspondent aux AWS Clean Rooms événements

Chaque modèle d'événement est un objet JSON qui contient :

• (Facultatif) : source attribut identifiant le service qui envoie l'événement. Pour les AWS Clean Rooms événements, la source estaws.cleanrooms.

• (Facultatif) : detail-type attribut qui contient un tableau des noms d'événements à associer.

• (Facultatif) : un attribut detail qui contient toute autre donnée d’événement à rechercher.

Par exemple, le modèle d'événement suivant correspond à tous les événements Membership Updated pour lesquels la collaboration a été supprimée AWS Clean Rooms :

{
  "source": ["aws.cleanrooms"],
  "detail-type": ["Membership Updated"],
  "detail": {
    "status": ["COLLABORATION_DELETED"]
  }
}

Pour plus d'informations sur la rédaction de modèles d'événements, consultez la section Modèles d'événements dans le guide de EventBridge l'utilisateur.