Création de règles sur Amazon EventBridge - Amazon EventBridge

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création de règles sur Amazon EventBridge

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

  • Accès à la EventBridge console Amazon

  • Autorisations IAM appropriées pour créer des règles EventBridge

  • Compréhension de base des architectures axées sur les événements

Aperçu

Pour agir sur les événements reçus par EventBridge, vous pouvez créer des règles. Lorsqu'un événement correspond au modèle d'événement défini dans votre règle, EventBridge envoie l'événement à la cible spécifiée.

Cette rubrique explique comment créer une règle qui permet de EventBridge faire correspondre les événements tels qu'ils sont envoyés au bus d'événements spécifié.

La création de EventBridge règles implique quatre étapes principales :

  1. Choisissez les événements que vous souhaitez traiter

  2. Configuration du filtrage et des tests d'événements

  3. Sélection et configuration des cibles

  4. Configuration des paramètres des règles

Choisissez les événements

Choisissez d'abord les événements que vous souhaitez envoyer à la cible.

Pour sélectionner un événement
  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Rules, puis Create Rule.

  3. Dans l'onglet Événements, recherchez les événements que vous souhaitez envoyer à la cible :

    1. Choisissez les événements AWS de service ou les événements personnalisés.

    2. Utilisez le champ de recherche ou parcourez la liste des événements pour trouver les événements que vous souhaitez envoyer à la cible.

    3. Faites glisser un ou plusieurs événements dans le canevas de création et déposez-les sur Triggering Events.

    EventBridge affiche la section Événements déclencheurs. Contenu de cette section :

    • Événements, qui répertorie l'événement que vous avez choisi.

    • Schéma, qui affiche le schéma de l'événement sélectionné, s'il est disponible.

      Le schéma contient trois onglets :

      • Arborescence : vue arborescente du schéma de l'événement.

      • Code : schéma d'événement au format JSON ou aux spécifications Open API.

      • Info : informations générales sur le schéma.

    • Exemple d'événement, qui affiche un échantillon d'un événement sélectionné, si disponible.

    • Modèle d'événement (filtre), qui contient un modèle d'événement qui sélectionne tous les événements que vous avez choisis.

Filtrez les événements pour n'envoyer que ce que vous voulez

Vous ne voudrez probablement pas envoyer tous les événements d'un type spécifique à une cible. Vous pouvez rendre votre modèle d'événement plus spécifique afin qu'il ne sélectionne que les événements contenant les attributs et les valeurs qui vous intéressent.

Modifier le modèle d'événement (facultatif)

Dans le volet Événements déclencheurs, vous pouvez créer le modèle d'événement de deux manières :

  • Visuellement, en utilisant la vue de l'arborescence du schéma

  • En modifiant directement le JSON dans le volet Event Pattern

Pour modifier le modèle d'événement à l'aide de l'arborescence du schéma
  1. Choisissez l'onglet Arborescence du volet Schéma.

  2. Ajoutez et modifiez des filtres pour définir le modèle d'événement.

    1. Cliquez sur l'icône de filtre à côté de l'attribut que vous souhaitez ajouter en tant que filtre au modèle d'événement.

    2. Choisissez un opérateur de comparaison dans la liste déroulante.

      Pour plus d'informations sur les opérateurs de comparaison, consultez la section Création de modèles d'événements.

    3. Entrez la valeur que vous souhaitez obtenir.

    4. Cliquez sur le crochet pour terminer.

    EventBridge ajoute le filtre que vous avez créé au JSON dans le volet Event Pattern.

  3. Ajoutez des filtres supplémentaires jusqu'à ce que vous ayez créé un modèle d'événement correspondant à tous les attributs d'événement souhaités.

Tester le modèle d'événement

Après avoir créé un modèle d'événement qui correspond à tous les attributs d'événement souhaités, testez pour vous assurer que le modèle d'événement fonctionne comme prévu.

Tester le modèle d'événement (facultatif)

  1. Choisissez un exemple d'événement à tester ou utilisez le vôtre.

    • Utiliser les exemples d'événements fournis

      1. Choisissez Utiliser les exemples d'événements fournis.

      2. Sous Exemple d'événement déclencheur, sélectionnez l'événement à utiliser pour les tests dans la liste déroulante.

    • Utilisez votre propre événement

      1. Choisissez Utiliser votre propre événement.

        EventBridge affiche un événement générique avec un details élément vide.

      2. Modifiez le JSON de l'événement pour créer l'événement par rapport auquel vous souhaitez tester votre modèle d'événement.

        Astuce

        Vous pouvez utiliser les exemples d'événements fournis comme point de départ pour créer vos propres événements personnalisés à utiliser dans vos tests :

        1. Choisissez Utiliser les exemples d'événements fournis, choisissez un événement dans l'exemple d'événement déclencheur, puis choisissez Copier.

        2. Choisissez Utiliser votre propre événement.

        3. Sélectionnez l'événement dans son intégralité dans la fenêtre, puis collez l'exemple d'événement par-dessus.

        4. Modifiez l'événement comme vous le souhaitez.

  2. Choisissez Run Test.

    EventBridge affiche un message indiquant si l'événement de test correspond au modèle d'événement.

Sélection des cibles

Faites glisser une cible (et jusqu'à cinq) dans le canevas de construction et déposez-la sur Targets pour recevoir des événements correspondant au modèle d'événements spécifié. Les cibles peuvent inclure :

  • Autres bus EventBridge événementiels, identiques ou différents Compte AWS

  • EventBridge Destinations d'API, y compris les partenaires SaaS tels que Salesforce

  • Une gamme de ressources de AWS service, telles que les files d'attente Amazon SQS ou les rubriques Amazon SNS

Pour sélectionner des cibles
  1. Sélectionnez le type de cible dans le volet Targets et déposez-le sur la forme Targets dans le canevas Build.

    EventBridge affiche la section Cible dans le build, avec les options de configuration applicables en fonction du type de cible que vous avez sélectionné.

    Astuce

    Si vous avez spécifié plusieurs cibles, la sélection de la forme cible affiche la section de configuration de cette cible.

  2. Configurez la cible en fonction de votre type de cible. Pour connaître les étapes de configuration détaillées, consultez la section EventBridge Cibles.

Personnalisez les données d'événement envoyées à la cible

Si vous sélectionnez une cible autre qu'un bus d' EventBridge événements ou une destination d' EventBridge API, vous avez la possibilité de personnaliser les données réellement transmises à la cible.

Transformer ou remplacer les données d'événement envoyées (facultatif)

  1. Dans le canevas de conception Build, choisissez l'icône de transformation d'entrée dans la forme Targets.

    EventBridge affiche la section Transformation des entrées.

  2. Sous Configuration de la transformation des entrées, sélectionnez Activer.

  3. Sélectionnez la méthode de transformation pour choisir la manière dont vous souhaitez personnaliser le texte envoyé à la cible pour les événements correspondants :

    • Partie des événements correspondants : envoie EventBridge uniquement la partie spécifiée de l'événement source d'origine à la cible.

    • Constante (texte JSON) : EventBridge envoie uniquement le texte JSON spécifié à la cible. Aucune partie de l’événement source d’origine n’est envoyée.

    • Transformateur d'entrée : configurez un transformateur d'entrée pour personnaliser le texte que vous EventBridge souhaitez envoyer à la cible. Pour plus d'informations, consultez la section Transformation de l'entrée cible.

Configuration de la règle

Enfin, configurez et créez la règle.

Pour configurer la règle (console)
  1. Choisissez Configurer.

  2. Entrez un Nom et éventuellement une Description pour la règle.

    Une règle ne peut pas porter le même nom qu'une autre règle du même bus Région AWS d'événements ou du même bus d'événements.

  3. Pour Bus d’événements, choisissez le bus d’événements à associer à cette règle.

    Si vous souhaitez que cette règle corresponde aux événements provenant de votre compte, sélectionnez Bus d’événements par défaut AWS . Lorsqu'un élément Service AWS de votre compte envoie un événement, celui-ci est toujours redirigé vers le bus d'événements par défaut de votre compte.

  4. Pour activer la règle dès sa création, sous Activation, activez Active.

  5. (Facultatif) Saisissez une ou plusieurs balises pour la règle. Pour de plus amples informations, veuillez consulter Marquage des ressources sur Amazon EventBridge.

  6. Choisissez Créer.

Étapes suivantes

Après avoir créé votre règle, vous pouvez :

Ressources supplémentaires

Pour plus d'informations sur EventBridge les règles, voir :