Création de règles Amazon EventBridge qui réagissent aux événements - Amazon EventBridge
Création d'une règle qui réagit aux événements

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

Pour effectuer une action lorsque des événements sont 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 :

Création d'une règle qui réagit aux événements

Les étapes suivantes expliquent comment créer une règle utilisée par EventBridge pour faire correspondre les événements lorsqu'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 console Amazon EventBridge à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Rules.

  3. Choisissez Create rule (Créer une règle).

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

    Une règle ne peut pas avoir le même nom qu'une autre règle de la même Région AWS et sur le même bus d'événement.

  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 Service AWS de votre compte émet un événement, il accède toujours au bus d'événement par défaut de votre compte.

  6. Pour Rule type (Type de règle), choisissez Rule with an event pattern (Règle avec un modèle d'événement).

  7. Choisissez Next (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. Pour Event source (Origine de l'événement), choisissez events or EventBridge partner events (Événements AWS ou événements partenaires EventBridge).

  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 :

    • Événements AWS : faites votre choix parmi les événements émis par les Services AWS pris en charge.

    • Événements partenaires EventBridge : faites votre choix parmi les événements émis par des services tiers prenant 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 partenaire comme point de départ pour créer votre propre événement personnalisé.

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

      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 la structure de l'exemple d'événement dans le volet d'édition JSON et collez l'événement AWS ou 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 schéma ou d'un modèle EventBridge, ou créer un modèle d'événement personnalisé.

    Existing schema

    Pour utiliser un schéma EventBridge existant pour 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 un 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 un 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 un 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 rendu tel quel dans le Générateur de modèle, EventBridge vous avertit avant d'ouvrir le Générateur de modèle.

  4. Choisissez Next (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'événements EventBridge, des destinations d'API EventBridge, 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

    Pour sélectionner un bus d'événements EventBridge, sélectionnez Bus d'événements EventBridge, puis procédez comme suit :

    API destination

    Pour utiliser une destination d'API EventBridge, sélectionnez Destination d'API EventBridge, puis effectuez l'une des opérations suivantes :

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

    Pour de plus amples informations, veuillez consulter Destinations d’API.

    Service AWS

    Pour utiliser un Service AWS, sélectionnez Service AWS, puis procédez comme suit :

    1. Pour Sélectionner une cible, sélectionnez un Service AWS à utiliser comme cible. 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 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 ce cas, EventBridge peut 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.

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

    Event bus

    (Facultatif) Pour File d'attente de lettres mortes, indiquez s'il convient d'utiliser une file d'attente Amazon SQS standard en tant que file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente de lettres mortes s'ils ne sont pas correctement remis à 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 joindre une stratégie basée sur les ressources à la file d'attente qui accorde l'autorisation EventBridge pour lui envoyer des messages.

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

    API destination

    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 : EventBridge envoie 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 qu'EventBridge doit 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 au format JSON, spécifiez le texte JSON qu'EventBridge doit envoyer à la cible plutôt qu'à l'événement.

      • Transformateur d'entrée : configurez un transformateur d'entrée pour personnaliser le texte qu'EventBridge doit 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 dans le cadre de la création d’une règle.

    2. (Facultatif) Sous Politique de nouvelles tentatives, spécifiez la manière dont EventBridge doit réessayer d'envoyer un événement à une cible après qu'une erreur se soit produite.

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

      • Nouvelles tentatives : entrez le nombre maximal de fois où EventBridge doit réessayer d'envoyer un événement à la cible après qu'une erreur se soit produite. La valeur par défaut est 185 fois.

    3. (Facultatif) Pour File d'attente de lettres mortes, indiquez s'il convient d'utiliser une file d'attente Amazon SQS standard en tant que file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente de lettres mortes s'ils ne sont pas correctement remis à 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 joindre une stratégie basée sur les ressources à la file d'attente qui accorde l'autorisation EventBridge pour lui envoyer des messages.

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

    AWS service

    Notez qu'EventBridge peut ne pas afficher tous les champs suivants pour un service AWS 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 : EventBridge envoie 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 qu'EventBridge doit 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 au format JSON, spécifiez le texte JSON qu'EventBridge doit envoyer à la cible plutôt qu'à l'événement.

      • Transformateur d'entrée : configurez un transformateur d'entrée pour personnaliser le texte qu'EventBridge doit 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 dans le cadre de la création d’une règle.

    2. (Facultatif) Sous Politique de nouvelles tentatives, spécifiez la manière dont EventBridge doit réessayer d'envoyer un événement à une cible après qu'une erreur se soit produite.

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

      • Nouvelles tentatives : entrez le nombre maximal de fois où EventBridge doit réessayer d'envoyer un événement à la cible après qu'une erreur se soit produite. La valeur par défaut est 185 fois.

    3. (Facultatif) Pour File d'attente de lettres mortes, indiquez s'il convient d'utiliser une file d'attente Amazon SQS standard en tant que file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente de lettres mortes s'ils ne sont pas correctement remis à 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 joindre une stratégie basée sur les ressources à la file d'attente qui accorde l'autorisation EventBridge pour lui envoyer des messages.

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

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

  5. Choisissez Next (Suivant).

Notez qu'EventBridge peut ne pas afficher tous les champs suivants pour un service AWS donné.

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 EventBridge Balises Amazon.

  2. Choisissez Next (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.