Configuration d’un transformateur d’entrée dans le cadre de la création d’une règle

Lors de la création d'une règle, vous pouvez spécifier un transformateur d'entrée EventBridge à utiliser pour traiter les événements correspondants avant de les envoyer à la cible spécifiée. Vous pouvez configurer des transformateurs d'entrée pour des cibles qui sont des AWS services ou des destinations d'API.

Pour créer un transformateur d’entrée cible dans le cadre d’une règle

1. Suivez les étapes de création d’une règle, comme décrit dans Création de règles Amazon EventBridge qui réagissent aux événements.

2. À l’Étape 3 : Sélectionner la ou les cibles, développez Réglages supplémentaires.

3. Pour Configurer l’entrée cible, choisissez Transformateur d’entrée dans la liste déroulante.

   Cliquez sur Configurer le transformateur d’entrée.

   EventBridge affiche la boîte de dialogue Configurer le transformateur d'entrée.

4. Dans la section Exemple d’événement, choisissez un Type d’exemple d’événement par rapport auquel vous souhaitez tester votre modèle d’événement. Vous pouvez choisir un AWS événement, un événement partenaire ou créer votre propre événement personnalisé.

   AWS events

   Faites votre choix parmi les événements émis par les Services AWS pris en charge.

   1. Sélectionnez Événements AWS .

   2. Sous Exemples d'événements, sélectionnez l' AWS événement souhaité. Les événements sont organisés par AWS service.

      Lorsque vous sélectionnez un événement, il EventBridge renseigne l'exemple d'événement.

      Par exemple, si vous choisissez S3 Object Created, EventBridge affiche un exemple d'événement S3 Object Created.

   3. (Facultatif) Vous pouvez également sélectionner Copier pour copier l’exemple d’événement dans le presse-papiers de votre appareil.

   Partner events

   Choisissez parmi les événements émis par les services tiers pris en charge EventBridge, tels que Salesforce.

   1. Sélectionnez les événements EventBridge partenaires.

   2. Sous Exemples d’événements, choisissez l’événement partenaire souhaité. Les événements sont organisés par partenaire.

      Lorsque vous sélectionnez un événement, il EventBridge renseigne l'exemple d'événement.

   3. (Facultatif) Vous pouvez également sélectionner Copier pour copier l’exemple d’événement dans le presse-papiers de votre appareil.

   Enter your own

   Entrez votre propre événement au format texte JSON.

   1. Sélectionnez Saisir mon propre.

   2. EventBridge remplit l'exemple d'événement avec un modèle d'attributs d'événement obligatoires.

   3. Modifiez et faites des ajouts à l’exemple d’événement selon vos besoins. L’exemple d’événement doit être au format JSON valide.

   4. (Facultatif) Vous pouvez également choisir l’une des options suivantes :

      • Copier : copiez l’exemple 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.

5. (Facultatif) Développez la section Exemples de chemins d’entrée, de modèles et de sorties pour afficher les exemples suivants :

   • Comment les chemins JSON sont-ils utilisés pour définir des variables qui représentent les données d’événement

   • Comment ces variables peuvent être utilisées dans un modèle de transformateur d’entrée

   • La sortie résultante qui est EventBridge envoyée à la cible

   Pour obtenir des exemples plus détaillés de transformations d’entrée, consultez Exemples de transformation d’entrée.

6. Dans la section Transformateur d’entrée cible, définissez les variables que vous souhaitez utiliser dans le modèle d’entrée.

   Les variables utilisent le chemin JSON pour référencer des valeurs dans la source d’événement d’origine. Vous pouvez ensuite référencer ces variables dans le modèle d'entrée afin d'inclure les données de l'événement source d'origine dans l'événement transformé EventBridge transmis à la cible. Vous pouvez définir jusqu’à 100 variables. Le transformateur d’entrée doit être au format JSON valide.

   Supposons, par exemple, que vous ayez choisi l' AWS événement S3 Object Created comme exemple d'événement pour ce transformateur d'entrée. Vous pouvez alors définir les variables suivantes à utiliser dans votre modèle :

   {
     "requester": "$.detail.requester",
     "key": "$.detail.object.key",
     "bucket": "$.detail.bucket.name"
   }

   (Facultatif) Vous pouvez également choisir Copier pour copier le transformateur d’entrée dans le presse-papiers de votre appareil.

7. Dans la section Modèle, composez le modèle que vous souhaitez utiliser pour déterminer ce qui EventBridge passe à la cible.

   Vous pouvez utiliser du code JSON, des chaînes, des informations statiques, les variables que vous avez définies ainsi que des variables réservées. Pour obtenir des exemples plus détaillés de transformations d’entrée, consultez Exemples de transformation d’entrée.

   Par exemple, supposons que vous avez défini les variables dans l’exemple précédent. Vous pouvez alors composer le modèle suivant, qui fait référence à ces variables, ainsi qu’aux variables réservées et aux informations statiques.

   {
       "message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
       "RuleName": <aws.events.rule-name>,
       "ruleArn" : <aws.events.rule-arn>,
       "Transformed": "Yes"
   }

   (Facultatif) Vous pouvez également choisir Copier pour copier le modèle dans le presse-papiers de votre appareil.

8. Pour tester votre modèle, sélectionnez Générer une sortie.

   EventBridge traite l'exemple d'événement en fonction du modèle d'entrée et affiche la sortie transformée générée sous Sortie. Il s'agit des informations qui EventBridge seront transmises à la cible à la place de l'événement source d'origine.

   La sortie générée pour l’exemple de modèle d’entrée décrit ci-dessus est la suivante :

   {
       "message": "123456789012 has created the object "example-key" in the bucket "example-bucket"",
       "RuleName": rule-name,
       "ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
       "Transformed": "Yes"
   }

   (Facultatif) Vous pouvez également choisir Copier pour copier la sortie générée dans le presse-papiers de votre appareil.

9. Sélectionnez Confirmer.

10. Suivez le reste des étapes de création d’une règle, comme décrit dans Création de règles Amazon EventBridge qui réagissent aux événements.