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.

# Tutoriel : Utiliser des transformateurs d'entrée pour transformer des événements en EventBridge
<a name="eb-input-transformer-tutorial"></a>

Vous pouvez utiliser le [transformateur d'entrée](eb-transform-target-input.md) EventBridge pour personnaliser le texte d'un [événement](eb-events.md) avant de l'envoyer à la cible d'une [règle](eb-rules.md). 

Pour ce faire, vous définissez des chemins JSON depuis l’événement et affectez leurs sorties à différentes variables. Vous pouvez ensuite utiliser ces variables dans le modèle d’entrée. Les caractères < et > ne peuvent pas être placés dans une séquence d’échappement. Pour plus d’informations, consultez [Transformation des EventBridge entrées Amazon](eb-transform-target-input.md).

**Note**  
Si vous spécifiez une variable à mettre en relation avec un chemin JSON qui n'existe pas dans l'événement, la variable n’est pas créée et n’apparaît pas dans la sortie.

Dans ce didacticiel, vous allez créer une règle qui correspond à un événement avec `detail-type: "customerCreated"`. Le transformateur d’entrée mappe la variable `type` au chemin JSON \$1.detail-type depuis l’événement. Place EventBridge ensuite la variable dans le modèle de saisie « Cet événement s'est produit <type>». Le résultat est le message Amazon SNS suivant.

```
"This event was of customerCreated type."
```

**Topics**
+ [Étape 1 : Créer une rubrique Amazon SNS](#eb-input-transformer-tutorial-create-topic)
+ [Étape 2 : Créer un abonnement Amazon SNS](#eb-input-transformer-tutorial-create-sns)
+ [Étape 3 : Créer une règle](#eb-input-transformer-create-rule)
+ [Étape 4 : Envoyer des événements de test](#eb-input-transformer-send-test-events)
+ [Étape 5 : Confirmer la bonne exécution](#success)
+ [Étape 6 : Nettoyer vos ressources](#cleanup)

## Étape 1 : Créer une rubrique Amazon SNS
<a name="eb-input-transformer-tutorial-create-topic"></a>

Créez un sujet pour recevoir les événements EventBridge.

**Pour créer une rubrique**

1. [Ouvrez la console Amazon SNS à l'adresse v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)

1. Dans le volet de navigation, choisissez **Rubriques**.

1. Choisissez **Créer une rubrique**.

1. Pour **Type**, choisissez **Standard**.

1. Entrez **eventbridge-IT-test** comme nom de la rubrique.

1. Choisissez **Créer une rubrique**.

## Étape 2 : Créer un abonnement Amazon SNS
<a name="eb-input-transformer-tutorial-create-sns"></a>

Créez un abonnement pour obtenir des e-mails contenant les informations transformées.

**Pour créer un abonnement**

1. [Ouvrez la console Amazon SNS à l'adresse v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)

1. Dans le panneau de navigation, sélectionnez **Abonnements**.

1. Choisissez **Créer un abonnement**.

1. Pour **ARN de la rubrique**, choisissez la rubrique que vous avez créée à l’étape 1. Pour ce didacticiel, choisissez **eventbridge-IT-test**.

1. Pour **Protocole**, choisissez **E-mail**.

1. Saisissez votre adresse e-mail dans **Endpoint (Point de terminaison)**.

1. Choisissez **Create subscription** (Créer un abonnement).

1. Confirmez l’abonnement en choisissant **Confirmer l’abonnement** dans l’e-mail que vous recevez du service de notifications AWS .

## Étape 3 : Créer une règle
<a name="eb-input-transformer-create-rule"></a>

Créez une règle de sorte qu’elle utilise le transformateur d’entrée pour personnaliser les informations d’état d’instance à destination d’une cible.

**Pour créer une règle**

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

1. Dans le volet de navigation, choisissez **Règles**.

1. Choisissez **Créer une règle**.

1. Saisissez un nom et une description pour la règle. Par exemple, nommez la règle `ARTestRule`

1. Pour **Event bus** (Bus d'événement), sélectionnez le bus d'événement que vous souhaitez associer à cette règle. Si vous souhaitez que cette règle mette en correspondance les événements en provenance de votre compte, sélectionnez **Par défaut**. 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.

1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.

1. Choisissez **Suivant**.

1. Pour **Event source** (Source de l'événement), choisissez **Other** (Autres).

1. Pour **Modèle d’événement**, entrez ce qui suit :

   ```
   {
     "detail-type": [
       "customerCreated"
     ]
   }
   ```

1. Choisissez **Suivant**.

1. Pour **Types de cibles**, choisissez **service AWS **.

1. Pour **Sélectionner une cible**, choisissez **Rubrique SNS** dans la liste déroulante.

1. Pour **Rubrique**, sélectionnez la rubrique Amazon SNS que vous avez créée à l’étape 1. Pour ce didacticiel, choisissez **eventbridge-IT-test**.

1. Pour **Réglages supplémentaires**, procédez comme suit :

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

   1. Choisissez **Configurer le transformateur d’entrée**.

   1. Pour **Exemples d’événements**, entrez ce qui suit :

      ```
      {
        "detail-type": "customerCreated"
      }
      ```

   1. Pour **Transformateur d’entrée cible**, procédez comme suit :

      1. Pour **Chemin d’entrée**, entrez ce qui suit :

         ```
         {"detail-type":"$.detail-type"}
         ```

      1. Pour **Modèle d’entrée**, entrez ce qui suit :

         ```
         "This event was of <detail-type> type."
         ```

   1. Choisissez **Confirmer**.

1. Choisissez **Suivant**.

1. Choisissez **Suivant**.

1. Consultez les détails de la règle et choisissez **Create rule** (Créer une règle).

## Étape 4 : Envoyer des événements de test
<a name="eb-input-transformer-send-test-events"></a>

Maintenant que vous avez configuré la rubrique SNS et la règle, nous allons envoyer des événements de test pour vérifier que la règle fonctionne correctement.

**Pour envoyer des événements de test (console)**

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

1. Dans le volet de navigation, sélectionnez **Event Buses (Bus d'événements)**.

1. Dans la vignette **Bus d’événements par défaut**, choisissez **Actions**, **Envoyer des événements**.

1. Entrez une source d’événements. Par exemple, `TestEvent`.

1. Pour **Type de détails**, entrez `customerCreated`.

1. Pour **Détails de l’événement**, entrez `{}`.

1. Sélectionnez **Send (Envoyer)**.

## Étape 5 : Confirmer la bonne exécution
<a name="success"></a>

Si vous recevez un e-mail de AWS notification correspondant au résultat attendu, cela signifie que vous avez terminé le didacticiel avec succès.

## Étape 6 : Nettoyer vos ressources
<a name="cleanup"></a>

Vous pouvez maintenant supprimer les ressources que vous avez créées pour ce didacticiel, sauf si vous souhaitez les conserver. En supprimant AWS les ressources que vous n'utilisez plus, vous évitez des frais inutiles sur votre AWS compte.

**Pour supprimer la rubrique SNS**

1. Ouvrez la [page Rubriques](https://console.aws.amazon.com/sns/v3/home#/topics) de la console SNS.

1. Sélectionnez la rubrique que vous avez créée.

1. Sélectionnez **Delete (Supprimer)**.

1. Saisissez **delete me**.

1. Sélectionnez **Delete (Supprimer)**.

**Pour supprimer l’abonnement SNS**

1. Ouvrez la [page Abonnements](https://console.aws.amazon.com/sns/v3/home#/subscriptions) de la console SNS.

1. Sélectionnez l’abonnement que vous avez créé.

1. Sélectionnez **Delete (Supprimer)**.

1. Sélectionnez **Delete (Supprimer)**.

**Pour supprimer la ou les EventBridge règles**

1. Ouvrez la [page Règles](https://console.aws.amazon.com/events/home#/rules) de la EventBridge console.

1. Sélectionnez la ou les règles que vous avez créées.

1. Sélectionnez **Delete (Supprimer)**.

1. Sélectionnez **Supprimer**.