Test d'un transformateur d'entrée cible à l'aide du EventBridge Sandbox - Amazon EventBridge

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.

Test d'un transformateur d'entrée cible à l'aide du EventBridge Sandbox

Vous pouvez utiliser des transformateurs d'entrée pour personnaliser le texte d'un événement avant de EventBridge transmettre les informations à la cible d'une règle.

La configuration d’un transformateur d’entrée fait généralement partie du processus plus vaste qui consiste à spécifier une cible lors de la création d’une nouvelle règle ou de la modification d’une règle existante. En utilisant le Sandbox EventBridge, vous pouvez toutefois configurer rapidement un transformateur d'entrée et utiliser un exemple d'événement pour confirmer que vous obtenez la sortie souhaitée, sans avoir à créer ou à modifier de règle.

Pour plus d’informations sur les transformations d’entrée, consultez Transformation des EventBridge entrées Amazon.

Pour tester un transformateur d’entrée cible

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

  2. Sous Ressources pour développeurs, choisissez Environnement de test (sandbox), puis sur la page Environnement de test (sandbox), cliquez sur l’onglet Transformateur d’entrée cible.

  3. 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 des services tiers compatibles 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 dans le JSON texte.

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

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

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

    • Comment les JSON chemins sont-ils utilisés pour définir les variables représentant les données d'événements

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

  5. 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 JSON le chemin pour référencer les 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 valideJSON.

    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.

  6. 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 des chaînesJSON, des informations statiques, des 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.

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