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 dans 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 — Choisissez 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.

    • Entrez le mien — Entrez votre propre événement dans JSON le texte.

      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 JSON d'édition et collez l'événement AWS ou l'événement partenaire à sa place.

      6. Modifiez l'événement JSON 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 dans JSON pour générer et valider votre modèle d'événement sous forme de JSON texte.

    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 JSON du texte 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 sous forme de JSON texte 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 dans JSON pour générer et valider votre modèle d'événement sous forme de JSON texte.

    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 JSON du texte en ajoutant des sauts de ligne, des tabulations et des espaces.

    Event pattern

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

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

    2. Pour Modèle d'événement, entrez votre modèle d'événement personnalisé sous forme de JSON texte au format.

    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 JSON du texte 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 EventBridge API destinations, 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' EventBridge événements, sélectionnez le bus d'EventBridge événements, puis procédez comme suit :

    API destination

    Pour utiliser une EventBridge API destination, EventBridge APIsélectionnez-la, puis effectuez l'une des opérations suivantes :

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

    • Pour créer une nouvelle API destination, sélectionnez Créer une nouvelle API destination. 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.

      • APIpoint de terminaison de destination : URL point de terminaison de la cible.

        Le point de terminaison URL doit commencer parhttps. 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.

      • HTTPméthode — Sélectionnez la HTTP méthode utilisée lorsque vous appelez 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 plus d’informations, consultez APIdestinations comme cibles sur Amazon EventBridge.

    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 du bus d'événements disponibles dans la EventBridge console.

  2. Pour de nombreux types de cibles, EventBridge nécessite des autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le IAM rôle 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 la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'SQSattente Amazon 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 SQS file d'attente Amazon 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électionnez une SQS file d'attente Amazon dans un autre AWS compte en tant que file d'attente de lettres mortes, puis saisissez la file ARN 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 plus d’informations, consultez 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 : 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 JSON chemin qui définit la partie de l'événement que vous EventBridge souhaitez envoyer à la cible.

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

        Sous Spécifier la constante dans JSON, spécifiez le JSON texte 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 plus d’informations, consultez 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'SQSattente Amazon 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 SQS file d'attente Amazon 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électionnez une SQS file d'attente Amazon dans un autre AWS compte en tant que file d'attente de lettres mortes, puis saisissez la file ARN 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 plus d’informations, consultez Octroi d’autorisations à la file d’attente de lettres mortes.

    AWS service

    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 JSON chemin qui définit la partie de l'événement que vous EventBridge souhaitez envoyer à la cible.

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

        Sous Spécifier la constante dans JSON, spécifiez le JSON texte 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 plus d’informations, consultez 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'SQSattente Amazon 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 SQS file d'attente Amazon 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électionnez une SQS file d'attente Amazon dans un autre AWS compte en tant que file d'attente de lettres mortes, puis saisissez la file ARN 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 plus d’informations, consultez 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 Suivant.

Notez que tous les champs suivants EventBridge peuvent ne pas être affichés pour un AWS service 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 plus d’informations, consultez 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.