Tester un modèle d'événement à l'aide du EventBridge Sandbox

Les règles utilisent des modèles d’événements pour sélectionner des événements et les envoyer vers des cibles. Les modèles d’événement ont la même structure que les événements auxquels ils correspondent. Soit un modèle d’événement correspond à un événement, soit il n’y correspond pas.

La définition d’un modèle d’événement fait généralement partie du processus plus large de création d’une nouvelle règle ou de modification d’une règle existante. En utilisant le Sandbox EventBridge, vous pouvez toutefois définir rapidement un modèle d'événement et utiliser un exemple d'événement pour confirmer que le modèle correspond aux événements souhaités, sans avoir à créer ou à modifier de règle. Une fois que vous avez testé votre modèle d'événement, EventBridge offrez-vous la possibilité de créer une nouvelle règle en utilisant ce modèle d'événement directement depuis le sandbox.

Pour plus d’informations sur les modèles d’événements, consultez Modèles d' EventBridge événements Amazon.

Important

Dans EventBridge, il est possible de créer des règles pouvant entraîner des higher-than-expected frais et des ralentissements. Par exemple, vous pouvez créer par inadvertance une règle qui entraîne une boucle infinie, dans laquelle une règle est déclenchée de manière récursive sans fin. Supposons que vous avez créé une règle permettant de détecter que les listes ACL ont été modifiées sur un compartiment Amazon S3 et de déclencher un logiciel pour les modifier afin qu’elles aient l’état souhaité. Si la règle n'est pas correctement écrite, la modification suivante des listes de contrôle d'accès (ACL) déclenche à nouveau la règle, créant ainsi une boucle infinie.

Pour obtenir des conseils sur la façon d’écrire des règles et des modèles d’événements précis afin de réduire au maximum ces résultats inattendus, consultez Bonnes pratiques lors de la définition de règles Amazon EventBridge et Bonnes pratiques lors de la définition des modèles EventBridge d'événements Amazon.

Pour tester un modèle d'événement à l'aide du EventBridge sandbox

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

2. Dans le volet de navigation, choisissez Ressources pour développeurs, puis sélectionnez Environnement de test (sandbox), et sur la page Environnement de test (sandbox), choisissez l'onglet Modèle d'événement.

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

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

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

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

6. (Facultatif) Pour créer une règle avec ce modèle d’événement et l’affecter à un bus d’événements spécifique, choisissez Créer une règle avec un modèle.

   EventBridge vous amène à l'étape 1 de la section Créer une règle, que vous pouvez utiliser pour créer une règle et l'attribuer au bus d'événements de votre choix.

   Notez que l’Étape 2 : Générer un modèle d’événement contient les informations du modèle d’événement que vous avez déjà spécifiées et que vous pouvez accepter ou mettre à jour.

   Pour plus d’informations sur la création de règles, consultez Création de règles Amazon EventBridge qui réagissent aux événements.