Création de règles qui réagissent aux événements sur Amazon EventBridge - Amazon EventBridge
Définition de la règleCréation du modèle d’événementSélection des ciblesConfiguration des balises et vérification de la règle

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 qui réagissent aux événements sur Amazon EventBridge

Pour agir sur les événements reçus par Amazon 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 et déclenche l'action définie dans la règle.

La vidéo suivante explique comment créer différents types de règles et comment les tester :

Les étapes suivantes vous expliquent comment créer une règle qui permet de faire EventBridge correspondre les événements tels qu'ils sont envoyés au bus d'événements spécifié.

Définition de la règle

Commencez par entrer un nom et une description pour identifier la règle. Vous devez également définir le bus d’événements dans lequel votre règle recherche les événements correspondant à un modèle d’événement.

Pour définir les détails de la règle

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Règles.

  3. Choisissez Créer une règle.

  4. 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.

  5. 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 événement Service AWS de votre compte est émis, il est toujours redirigé vers le bus d'événements par défaut de votre compte.

  6. Pour Type de règle, choisissez Règle avec un modèle d’événement.

  7. Choisissez Suivant.

Création du modèle d’événement

Créez ensuite le modèle d’événement. Pour ce faire, spécifiez la source de l’événement, choisissez la base du modèle d’événement et définissez les attributs et les valeurs sur lesquels vous souhaitez établir une correspondance. Vous pouvez également générer le modèle d’événement au format JSON et le tester par rapport à un exemple d’événement.

Pour créer le modèle d’événement

  1. Dans Source de l'événement, choisissez AWS des événements ou des événements EventBridge partenaires.

  2. (Facultatif) Dans la section Exemples d’événements, choisissez un Type d’exemple d’événement par rapport auquel vous souhaitez tester votre modèle d’événement.

    Les types d’exemples d’événements suivants sont disponibles :

    • AWS événements — Sélectionnez parmi les événements émis ou pris en charge Services AWS.

    • EventBridge événements partenaires : sélectionnez parmi les événements émis par des services tiers qui prennent en charge EventBridge, tels que Salesforce.

    • Saisir mon propre : entrez votre propre événement au format texte JSON.

      Vous pouvez également utiliser un événement AWS ou un événement partenaire comme point de départ pour créer votre propre événement personnalisé.

      1. Sélectionnez AWS des événements ou des événements EventBridge partenaires.

      2. Utilisez le menu déroulant Exemples d’événements pour sélectionner l’événement que vous souhaitez utiliser comme point de départ pour votre événement personnalisé.

        EventBridge affiche l'exemple d'événement.

      3. Sélectionnez Copier.

      4. Sélectionnez Saisir mon propre pour Type d’événement.

      5. Supprimez l'exemple de structure d'événement dans le volet d'édition JSON et collez l'événement AWS ou l'événement partenaire à sa place.

      6. Modifiez le code JSON de l’événement pour créer votre propre exemple d’événement.

  3. Choisissez une Méthode de création. Vous pouvez créer un modèle d'événement à partir d'un EventBridge schéma ou d'un modèle, ou vous pouvez créer un modèle d'événement personnalisé.

    Existing schema

    Pour utiliser un EventBridge schéma existant afin de créer le modèle d'événement, procédez comme suit :

    1. Dans la section Méthode de création, pour Méthode, sélectionnez Utiliser le schéma.

    2. Dans la section Modèle d’événement, pour Type de schéma, sélectionnez Sélectionner un schéma dans le registre des schémas.

    3. Pour le Registre des schémas, cliquez sur la liste déroulante et entrez le nom d’un registre de schémas, tel que aws.events. Vous pouvez également sélectionner une option dans la liste déroulante qui s’affiche.

    4. Pour Schéma, cliquez sur la liste déroulante et entrez le nom du schéma à utiliser. Par exemple, aws.s3@ObjectDeleted. Vous pouvez également sélectionner une option dans la liste déroulante qui s’affiche.

    5. Dans la section Modèles, cliquez sur le bouton Modifier en regard de n’importe quel attribut pour ouvrir ses propriétés. Définissez les champs Relation et Valeur selon vos besoins, puis choisissez Jeu pour enregistrer l’attribut.

      Note

      Pour en savoir plus sur la définition d’un attribut, cliquez sur l’icône Infos en regard du nom de l’attribut. Pour savoir comment définir les propriétés des attributs dans votre événement, ouvrez la section Remarque de la boîte de dialogue des propriétés des attributs.

      Pour supprimer les propriétés d’un attribut, cliquez sur le bouton Modifier correspondant à cet attribut, puis choisissez Effacer.

    6. Choisissez Générer un modèle d’événement au format JSON pour générer et valider votre modèle d’événement sous forme de texte JSON.

    7. (Facultatif) Pour tester l’exemple d’événement par rapport à votre modèle de test, choisissez Modèle de test.

      EventBridge affiche une boîte de message indiquant si votre exemple d'événement correspond au modèle d'événement.

      Vous pouvez également choisir l’une des options suivantes :

      • Copier : copiez le modèle d’événement dans le presse-papiers de votre appareil.

      • Prettify : facilite la lecture du texte JSON en ajoutant des sauts de ligne, des tabulations et des espaces.

    Custom schema

    Pour écrire un schéma personnalisé et le convertir en modèle d’événement, procédez comme suit :

    1. Dans la section Méthode de création, pour Méthode, choisissez Utiliser le schéma.

    2. Dans la section Modèle d’événement, pour Type de schéma, choisissez Saisir le schéma.

    3. Entrez votre schéma dans la zone de texte. Vous devez mettre en forme le schéma au format texte JSON valide.

    4. Dans la section Modèles, cliquez sur le bouton Modifier en regard de n’importe quel attribut pour ouvrir ses propriétés. Définissez les champs Relation et Valeur selon vos besoins, puis choisissez Jeu pour enregistrer l’attribut.

      Note

      Pour en savoir plus sur la définition d’un attribut, cliquez sur l’icône Infos en regard du nom de l’attribut. Pour savoir comment définir les propriétés des attributs dans votre événement, ouvrez la section Remarque de la boîte de dialogue des propriétés des attributs.

      Pour supprimer les propriétés d’un attribut, cliquez sur le bouton Modifier correspondant à cet attribut, puis choisissez Effacer.

    5. Choisissez Générer un modèle d’événement au format JSON pour générer et valider votre modèle d’événement sous forme de texte JSON.

    6. (Facultatif) Pour tester l’exemple d’événement par rapport à votre modèle de test, choisissez Modèle de test.

      EventBridge affiche une boîte de message indiquant si votre exemple d'événement correspond au modèle d'événement.

      Vous pouvez également choisir l’une des options suivantes :

      • Copier : copiez le modèle d’événement dans le presse-papiers de votre appareil.

      • Prettify : facilite la lecture du texte JSON en ajoutant des sauts de ligne, des tabulations et des espaces.

    Event pattern

    Pour écrire un modèle d’événement personnalisé au format JSON, procédez comme suit :

    1. Dans la section Méthode de création, pour Méthode, choisissez Modèle personnalisé (éditeur JSON).

    2. Pour Modèle d’événement, entrez votre modèle d’événement personnalisé au format texte JSON.

    3. (Facultatif) Pour tester l’exemple d’événement par rapport à votre modèle de test, choisissez Modèle de test.

      EventBridge affiche une boîte de message indiquant si votre exemple d'événement correspond au modèle d'événement.

      Vous pouvez également choisir l’une des options suivantes :

      • Copier : copiez le modèle d’événement dans le presse-papiers de votre appareil.

      • Prettify : facilite la lecture du texte JSON en ajoutant des sauts de ligne, des tabulations et des espaces.

      • Formulaire de modèle d’événement : ouvre le modèle d’événement dans le Générateur de modèle. Si le modèle ne peut pas être affiché tel quel dans Pattern Builder, vous EventBridge avertit avant qu'il n'ouvre Pattern Builder.

  4. Choisissez Suivant.

Sélection des cibles

Choisissez une ou plusieurs cibles pour recevoir des événements correspondant au modèle spécifié. Les cibles peuvent inclure un bus d' EventBridge événements, des destinations EventBridge d'API, y compris des partenaires SaaS tels que Salesforce, ou un autre Service AWS.

Pour sélectionner des cibles

  1. Pour Type de cible, choisissez l’un des types de cibles suivants :

    Event bus

    1. Sélectionnez le bus EventBridge événementiel.

    2. Choisissez le bus d'événements à utiliser comme cible.

    3. Pour de nombreux types de cibles, EventBridge a besoin d'autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le rôle IAM nécessaire à l'exécution de votre règle.

      Pour Rôle d’exécution, effectuez l’une des opérations suivantes :

      • Pour créer un nouveau rôle d’exécution pour cette règle :

        1. Sélectionnez Créer un rôle pour cette ressource spécifique.

        2. Entrez un nom pour ce rôle d'exécution ou utilisez le nom généré par EventBridge.

      • Pour utiliser un rôle d’exécution existant pour cette règle :

        1. Sélectionnez Utiliser le rôle existant.

        2. Entrez ou sélectionnez le nom du rôle d’exécution à utiliser dans la liste déroulante.

    4. (Facultatif) Pour Réglages supplémentaires, spécifiez l’un des paramètres facultatifs disponibles pour votre type de cible :

      (Facultatif) Pour la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS standard comme file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente des lettres mortes s'ils ne sont pas correctement transmis à la cible. Effectuez l’une des actions suivantes :

      • Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.

      • Choisissez Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue (Sélectionner une file d'attente Amazon SQS du compte AWS actuel à utiliser en tant que file d'attente de lettres mortes) et sélectionnez la file d'attente à utiliser dans la liste déroulante.

      • Choisissez Sélectionner une file d'attente Amazon SQS d'un autre compte AWS en tant que file d'attente de lettres mortes et saisissez l'ARN de la file d'attente à utiliser. Vous devez associer à la file d'attente une politique basée sur les ressources qui EventBridge autorise l'envoi de messages.

        Pour de plus amples informations, veuillez consulter Octroi d’autorisations à la file d’attente de lettres mortes.

    API destination

    1. Sélectionnez la destination de EventBridge l'API.

    2. Choisissez une destination d'API nouvelle ou existante :

      • Pour utiliser une destination d’API existante, sélectionnez Utiliser une destination d’API existante. Ensuite, sélectionnez une destination d’API dans la liste déroulante.

      • Pour créer une nouvelle destination d’API, sélectionnez Créer une nouvelle destination API. Fournissez ensuite les informations suivantes pour la destination :

        • Nom : entrez un nom pour la destination.

          Les noms doivent être uniques dans votre Compte AWS. Les noms peuvent comporter jusqu’à 64 caractères. Les caractères valides sont A-Z, a-z, 0-9 et . _ - (tiret).

        • (Facultatif) Description : entrez une description pour la destination.

          Les descriptions peuvent comporter jusqu’à 512 caractères.

        • Point de terminaison de la destination d’API : point de terminaison d’URL de la cible.

          L’URL du point de terminaison doit commencer par https. Vous pouvez inclure le caractère générique * en tant que paramètre de chemin. Vous pouvez définir les paramètres du chemin à partir de l’attribut HttpParameters de la cible.

        • Méthode HTTP : sélectionnez la méthode HTTP utilisée lorsque vous invoquez le point de terminaison.

        • (Facultatif) Limite du taux d’appel par seconde : entrez le nombre maximal d’invocations acceptées par seconde pour cette destination.

          Cette valeur doit être supérieure à zéro. Par défaut, cette valeur est définie sur 300.

        • Connexion : choisissez d’utiliser une connexion nouvelle ou existante :

          • Pour utiliser une connexion existante, sélectionnez Utiliser une connexion existante et sélectionnez la connexion dans la liste déroulante.

          • Pour créer une nouvelle connexion pour cette destination, sélectionnez Créer une nouvelle connexion, puis définissez le Nom, le Type de destination et le Type d’autorisation de la connexion. Vous pouvez également ajouter une Description facultative pour cette connexion.

    3. Pour de nombreux types de cibles, EventBridge a besoin d'autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le rôle IAM nécessaire à l'exécution de votre règle.

      Pour Rôle d’exécution, effectuez l’une des opérations suivantes :

      • Pour créer un nouveau rôle d’exécution pour cette règle :

        1. Sélectionnez Créer un rôle pour cette ressource spécifique.

        2. Entrez un nom pour ce rôle d'exécution ou utilisez le nom généré par EventBridge.

      • Pour utiliser un rôle d’exécution existant pour cette règle :

        1. Sélectionnez Utiliser le rôle existant.

        2. Entrez ou sélectionnez le nom du rôle d’exécution à utiliser dans la liste déroulante.

    4. (Facultatif) Pour Réglages supplémentaires, spécifiez l’un des paramètres facultatifs disponibles pour votre type de cible :

      Notez que tous les champs suivants EventBridge peuvent ne pas être affichés pour un AWS service donné.

      1. (Facultatif) Pour Configurer l’entrée cible, choisissez la manière dont vous souhaitez personnaliser le texte envoyé à la cible pour les événements correspondants. Sélectionnez l'une des méthodes suivantes :

        • Événements correspondants : EventBridge envoie l'intégralité de l'événement source d'origine à la cible. Il s’agit de l’option par défaut.

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

          Sous Spécifier la partie de l'événement correspondant, spécifiez un chemin JSON qui définit la partie de l'événement que vous EventBridge souhaitez envoyer à 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.

          Sous Spécifier la constante en JSON, spécifiez le texte JSON que vous EventBridge souhaitez envoyer à la cible plutôt que l'événement.

        • Transformateur d'entrée : configurez un transformateur d'entrée pour personnaliser le texte que vous souhaitez EventBridge envoyer à la cible. Pour de plus amples informations, veuillez consulter Transformation des EventBridge entrées Amazon.

          1. Sélectionnez Configurer le transformateur d’entrée.

          2. Configurez le transformateur d’entrée en suivant les étapes de la rubrique Configuration d'un transformateur d'entrée lors de la création d'une règle dans EventBridge.

      2. (Facultatif) Sous Politique de nouvelle tentative, spécifiez la manière dont vous EventBridge devez réessayer d'envoyer un événement à une cible en cas d'erreur.

        • Âge maximal de l'événement : entrez la durée maximale (en heures, minutes et secondes) pendant EventBridge laquelle les événements non traités sont conservés. La valeur par défaut est 24 heures.

        • Tentatives de nouvelle tentative : entrez le nombre maximum de tentatives d'envoi d'un événement à la cible après qu'une erreur se EventBridge soit produite. La valeur par défaut est 185 fois.

      3. (Facultatif) Pour la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS standard comme file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente des lettres mortes s'ils ne sont pas correctement transmis à la cible. Effectuez l’une des actions suivantes :

        • Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.

        • Choisissez Sélectionnez une file d'attente Amazon SQS dans le AWS compte courant à utiliser comme file d'attente de lettres mortes, puis sélectionnez la file d'attente à utiliser dans la liste déroulante.

        • Choisissez Sélectionner une file d'attente Amazon SQS d'un autre compte AWS en tant que file d'attente de lettres mortes et saisissez l'ARN de la file d'attente à utiliser. Vous devez associer à la file d'attente une politique basée sur les ressources qui EventBridge autorise l'envoi de messages.

          Pour de plus amples informations, veuillez consulter Octroi d’autorisations à la file d’attente de lettres mortes.

    Pour de plus amples informations, veuillez consulter Destinations d'API en tant que cibles sur Amazon EventBridge.

    Service AWS

    1. Sélectionnez Service AWS.

    2. Pour Sélectionner une cible, sélectionnez un Service AWS à utiliser comme cible.

    3. Si vous choisissez un AWS service qui prend en charge les cibles entre comptes, vous pouvez sélectionner une cible dans le même compte que le bus d'événements, ou sur un autre compte.

      • Pour une cible dans le même compte, pour Type de cible, sélectionnez Cible dans ce compte.

        1. Fournissez les informations demandées pour le service que vous sélectionnez.

          Note

          Les champs affichés varient en fonction du service sélectionné. Pour plus d’informations sur les cibles disponibles, consultez Cibles du bus d'événements disponibles dans la EventBridge console.

        2. Pour de nombreux types de cibles, EventBridge a besoin d'autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le rôle IAM nécessaire à l'exécution de votre règle.

          Pour Rôle d’exécution, effectuez l’une des opérations suivantes :

          • Pour créer un nouveau rôle d’exécution pour cette règle :

            1. Sélectionnez Créer un rôle pour cette ressource spécifique.

            2. Entrez un nom pour ce rôle d'exécution ou utilisez le nom généré par EventBridge.

          • Pour utiliser un rôle d’exécution existant pour cette règle :

            1. Sélectionnez Utiliser le rôle existant.

            2. Entrez ou sélectionnez le nom du rôle d’exécution à utiliser dans la liste déroulante.

      • Pour une cible dans un autre compte, pour Type de cible, sélectionnez Cible dans un autre AWS compte.

        1. Entrez l'ARN de la ressource cible à laquelle vous souhaitez envoyer des événements.

        2. Fournissez toutes les informations supplémentaires demandées pour le service que vous sélectionnez.

        3. Sélectionnez le nom du rôle d'exécution à utiliser dans la liste déroulante.

    4. (Facultatif) Pour Réglages supplémentaires, spécifiez l’un des paramètres facultatifs disponibles pour votre type de cible :

      1. (Facultatif) Pour Configurer l’entrée cible, choisissez la manière dont vous souhaitez personnaliser le texte envoyé à la cible pour les événements correspondants. Sélectionnez l'une des méthodes suivantes :

        • Événements correspondants : EventBridge envoie l'intégralité de l'événement source d'origine à la cible. Il s’agit de l’option par défaut.

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

          Sous Spécifier la partie de l'événement correspondant, spécifiez un chemin JSON qui définit la partie de l'événement que vous EventBridge souhaitez envoyer à 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.

          Sous Spécifier la constante en JSON, spécifiez le texte JSON que vous EventBridge souhaitez envoyer à la cible plutôt que l'événement.

        • Transformateur d'entrée : configurez un transformateur d'entrée pour personnaliser le texte que vous souhaitez EventBridge envoyer à la cible. Pour de plus amples informations, veuillez consulter Transformation des EventBridge entrées Amazon.

          1. Sélectionnez Configurer le transformateur d’entrée.

          2. Configurez le transformateur d’entrée en suivant les étapes de la rubrique Configuration d'un transformateur d'entrée lors de la création d'une règle dans EventBridge.

      2. (Facultatif) Sous Politique de nouvelle tentative, spécifiez la manière dont vous EventBridge devez réessayer d'envoyer un événement à une cible en cas d'erreur.

        • Âge maximal de l'événement : entrez la durée maximale (en heures, minutes et secondes) pendant EventBridge laquelle les événements non traités sont conservés. La valeur par défaut est 24 heures.

        • Tentatives de nouvelle tentative : entrez le nombre maximum de tentatives d'envoi d'un événement à la cible après qu'une erreur se EventBridge soit produite. La valeur par défaut est 185 fois.

      3. (Facultatif) Pour la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS standard comme file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente des lettres mortes s'ils ne sont pas correctement transmis à la cible. Effectuez l’une des actions suivantes :

        • Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.

        • Choisissez Sélectionnez une file d'attente Amazon SQS dans le AWS compte courant à utiliser comme file d'attente de lettres mortes, puis sélectionnez la file d'attente à utiliser dans la liste déroulante.

        • Choisissez Sélectionner une file d'attente Amazon SQS d'un autre compte AWS en tant que file d'attente de lettres mortes et saisissez l'ARN de la file d'attente à utiliser. Vous devez associer à la file d'attente une politique basée sur les ressources qui EventBridge autorise l'envoi de messages.

          Pour de plus amples informations, veuillez consulter Octroi d’autorisations à la file d’attente de lettres mortes.

  2. (Facultatif) Sélectionnez Add another target (Ajouter une autre cible) pour ajouter une nouvelle cible pour cette règle.

  3. Choisissez Suivant.

Configuration des balises et vérification de la règle

Pour finir, entrez les balises de votre choix pour la règle, puis passez en revue et créez la règle.

Pour configurer les balises, vérifier et créer la règle

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

  2. Choisissez Suivant.

  3. Passez en revue les détails de la nouvelle règle. Pour apporter des modifications à une section, choisissez le bouton Modifier en regard de cette section.

    Lorsque vous êtes satisfait des détails de la règle, choisissez Créer une règle.