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 à l'aide du générateur amélioré
<a name="eb-create-rule-visual"></a>

## Conditions préalables
<a name="eb-create-rule-prerequisites"></a>

Avant de commencer, assurez-vous de disposer des éléments suivants :
+ Accès à la EventBridge console Amazon
+ Autorisations IAM appropriées pour créer des règles EventBridge 
+ Compréhension de base des architectures axées sur les événements

## Présentation de
<a name="eb-create-rule-overview"></a>

Pour agir sur les événements reçus par 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.

Cette rubrique explique comment créer une règle qui permet de EventBridge faire correspondre les événements tels qu'ils sont envoyés au bus d'événements spécifié.

La création de EventBridge règles implique quatre étapes principales :

1. Choisissez les événements que vous souhaitez traiter

1. Configuration du filtrage et des tests d'événements

1. Sélection et configuration des cibles

1. Configuration des paramètres des règles

## Choisissez les événements
<a name="eb-create-rule-source"></a>

Choisissez d'abord les événements que vous souhaitez envoyer à la cible.

**Pour sélectionner un événement**

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 **Rules (Règles)**, puis **Create rule (Créer une règle)**.

1. Sur la page de sélection du générateur de règles, choisissez **Enhanced Builder**.

   Le générateur amélioré fournit un canevas visuel permettant de créer des règles et des cibles en faisant glisser des événements et des cibles. Pour utiliser des modèles et une configuration JSON à la place, consultez [Création de règles (Advanced Builder)](eb-create-rule-wizard.md).

1. Dans l'onglet **Événements**, recherchez les événements que vous souhaitez envoyer à la cible :

   1. Choisissez les **événements AWS de service** ou les **événements personnalisés**.

   1. Utilisez le champ de recherche ou parcourez la liste des événements pour trouver les événements que vous souhaitez envoyer à la cible.

   1. Faites glisser un ou plusieurs événements dans le canevas de **création** et déposez-les sur **Triggering Events**.

   EventBridge affiche la section **Événements déclencheurs**. Contenu de cette section :
   + **Événements**, qui répertorie l'événement que vous avez choisi.
   + **Schéma**, qui affiche le schéma de l'événement sélectionné, s'il est disponible.

     Le **schéma** contient trois onglets :
     + **Arborescence** : vue arborescente du schéma de l'événement.
     + **Code** : schéma d'événement au format JSON ou aux spécifications Open API.
     + **Info** : informations générales sur le schéma.
   + **Exemple d'événement**, qui affiche un échantillon d'un événement sélectionné, si disponible.
   + **Modèle d'événement (filtre)**, qui contient un modèle d'événement qui sélectionne tous les événements que vous avez choisis.

## Filtrez les événements pour n'envoyer que ce que vous voulez
<a name="eb-create-rule-event-pattern-visual"></a>

Vous ne voudrez probablement pas envoyer *tous les* événements d'un type spécifique à une cible. Vous pouvez rendre votre modèle d'événement plus spécifique afin qu'il ne sélectionne que les événements contenant les attributs et les valeurs qui vous intéressent.

### Modifier le modèle d'événement (facultatif)
<a name="eb-create-rule-event-pattern-steps"></a>

Dans le volet **Événements déclencheurs**, vous pouvez créer le modèle d'événement de deux manières :
+ Visuellement, en utilisant la vue arborescente du **schéma**
+ En modifiant directement le JSON dans le volet **Event Pattern**

**Pour modifier le modèle d'événement à l'aide de l'arborescence du schéma**

1. Choisissez l'onglet **Arborescence** du volet **Schéma**.

1. Ajoutez et modifiez des filtres pour définir le modèle d'événement.

   1. Cliquez sur l'icône de filtre à côté de l'attribut que vous souhaitez ajouter en tant que filtre au modèle d'événement.

   1. Choisissez un opérateur de comparaison dans la liste déroulante.

      Pour plus d'informations sur les opérateurs de comparaison, consultez la section [Création de modèles d'événements](eb-create-pattern-operators.md).

   1. Entrez la valeur que vous souhaitez obtenir.

   1. Cliquez sur le crochet pour terminer.

   EventBridge ajoute le filtre que vous avez créé au JSON dans le volet **Event Pattern**.

1. Ajoutez des filtres supplémentaires jusqu'à ce que vous ayez créé un modèle d'événement correspondant à tous les attributs d'événement souhaités.

### Tester le modèle d'événement
<a name="eb-create-rule-event-pattern-test"></a>

Après avoir créé un modèle d'événement qui correspond à tous les attributs d'événement souhaités, testez pour vous assurer que le modèle d'événement fonctionne comme prévu.

#### Tester le modèle d'événement (facultatif)
<a name="eb-create-rule-event-pattern-test-steps"></a>

1. Choisissez un exemple d'événement à tester ou utilisez le vôtre.
   + **Utiliser les exemples d'événements fournis**

     1. Choisissez **Utiliser les exemples d'événements fournis**.

     1. Sous **Exemple d'événement déclencheur**, sélectionnez l'événement à utiliser pour les tests dans la liste déroulante.
   + **Utilisez votre propre événement**

     1. Choisissez **Utiliser votre propre événement**.

        EventBridge affiche un événement générique avec un `details` élément vide.

     1. Modifiez le JSON de l'événement pour créer l'événement par rapport auquel vous souhaitez tester votre modèle d'événement.
**Astuce**  
Vous pouvez utiliser les exemples d’événements fournis comme points de départ pour créer vos propres événements personnalisés à utiliser dans vos tests :  
Choisissez **Utiliser les exemples d’événements fournis**, choisissez un événement dans **Exemple d’événement déclencheur**, puis choisissez **Copier**.
Choisissez **Utiliser votre propre événement**.
Sélectionnez l’événement dans son intégralité dans la fenêtre, puis collez l’exemple d’événement par-dessus.
Modifiez l’événement comme vous le souhaitez.

1. Choisissez **Run Test**.

   EventBridge affiche un message indiquant si l'événement de test correspond au modèle d'événement.

## Sélection des cibles
<a name="eb-create-rule-target-visual"></a>

Faites glisser une cible (et jusqu'à cinq) dans le canevas de **construction** et déposez-la sur **Targets** pour recevoir des événements correspondant au modèle d'événements spécifié. Les cibles peuvent inclure :
+ Autres bus EventBridge événementiels, identiques ou différents Compte AWS
+ EventBridge Destinations d'API, y compris les partenaires SaaS tels que Salesforce
+ Une gamme de ressources de AWS service, telles que les files d'attente Amazon SQS ou les rubriques Amazon SNS

**Pour sélectionner des cibles**

1. Sélectionnez le type de cible dans le volet **Targets** et déposez-le sur la forme **Targets** dans le canevas Build.

   EventBridge affiche la section **Cible** dans le build, avec les options de configuration applicables en fonction du type de cible que vous avez sélectionné.
**Astuce**  
Si vous avez spécifié plusieurs cibles, la sélection de la forme cible affiche la section de configuration de cette cible.

1. Configurez la cible en fonction de votre type de cible. Pour connaître les étapes de configuration détaillées, consultez la section [EventBridge Cibles](eb-targets.md).

### Personnalisez les données d'événement envoyées à la cible
<a name="eb-create-rule-target-transform"></a>

Si vous sélectionnez une cible autre qu'un bus d' EventBridge événements ou une destination d' EventBridge API, vous avez la possibilité de personnaliser les données réellement transmises à la cible.

#### Transformer ou remplacer les données d'événement envoyées (facultatif)
<a name="eb-create-rule-target-transform-steps"></a>

1. Dans le canevas de conception Build, choisissez l'icône de **transformation d'entrée** dans la forme **Targets**.

   EventBridge affiche la section **Transformation des entrées**.

1. Sous **Configuration de la transformation des entrées**, sélectionnez **Activer**.

1. Sélectionnez la méthode de transformation pour choisir la manière dont vous souhaitez personnaliser le texte envoyé à la cible pour les événements correspondants :
   + **Partie des événements correspondants** : envoie EventBridge uniquement la partie spécifiée de l'événement source d'origine à la cible.
   + **Constante (texte JSON)** : EventBridge envoie uniquement le texte JSON spécifié à la cible. Aucune partie de l’événement source d’origine n’est envoyée.
   + **Transformateur d'entrée** : configurez un transformateur d'entrée pour personnaliser le texte que vous EventBridge souhaitez envoyer à la cible. Pour plus d'informations, consultez la section [Transformation de l'entrée cible](eb-transform-target-input.md).

## Configuration de la règle
<a name="eb-create-rule-configure"></a>

Enfin, configurez et créez la règle.

**Pour configurer la règle (console)**

1. Choisissez **Configurer**.

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

1. 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 élément Service AWS de votre compte envoie un événement, celui-ci est toujours redirigé vers le bus d'événements par défaut de votre compte.

1. Pour activer la règle dès sa création, sous **Activation**, activez **Active**.

1. (Facultatif) Saisissez une ou plusieurs balises pour la règle. Pour de plus amples informations, veuillez consulter [Marquage des ressources sur Amazon EventBridge](eb-tagging.md).

1. Choisissez **Créer**.

## Étapes suivantes
<a name="eb-create-rule-next-steps"></a>

Après avoir créé votre règle, vous pouvez :
+ [Surveillez les performances des règles à l'aide de métriques](eb-monitoring.md)
+ [Testez votre règle avec des exemples d'événements](eb-event-pattern-sandbox.md)
+ [Modifiez les modèles d'événements selon les besoins](eb-event-patterns.md)
+ [Ajouter des cibles supplémentaires aux règles existantes](eb-targets.md)

## Ressources supplémentaires
<a name="eb-create-rule-additional-resources"></a>

Pour plus d'informations sur EventBridge les règles, voir :
+ [EventBridge aperçu des règles](eb-rules.md)
+ [Création de modèles d'événements](eb-event-patterns.md)
+ [EventBridge cibles](eb-targets.md)
+ [ EventBridge Règles de résolution des problèmes](eb-troubleshooting.md)