Commencer à utiliser Amazon EventBridge

La base EventBridge est de créer des règles qui acheminent les événements vers une cible. Dans cette section, vous allez créer une règle de base. Pour obtenir des didacticiels sur des scénarios spécifiques et des cibles spécifiques, consultez Didacticiels Amazon EventBridge.

Création d'une règle dans Amazon EventBridge

Pour créer une règle pour les événements, vous devez spécifier une action à effectuer lors de la EventBridge réception d'un événement qui correspond au modèle d'événement défini dans la règle. Lorsqu'un événement correspond, EventBridge envoie l'événement à la cible spécifiée et déclenche l'action définie dans la règle.

Lorsqu'un AWS service de votre AWS compte émet un événement, il est toujours redirigé vers le bus d'événements par défaut de votre compte. Pour écrire une règle qui correspond aux événements des AWS services de votre compte, vous devez l'associer au bus d'événements par défaut.

Pour créer une règle pour un AWS service

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

2. Dans le volet de navigation, choisissez Règles.

3. Choisissez Créer une règle.

4. Saisissez un nom et une description pour la règle.

   Une règle ne peut pas avoir le même nom qu'une autre règle de la même région et sur le même bus d'événement.

5. 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 corresponde aux événements provenant de votre compte, sélectionnez Bus d’événements par défaut AWS . 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.

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

7. Choisissez Suivant.

8. Pour Source d'événement, choisissez Services AWS .

9. (Facultatif) Pour Exemples d’événements, choisissez le type d’événement.

10. Pour Modèle d’événement, effectuez l’une des actions suivantes :

    • Pour utiliser un modèle pour créer votre modèle d’événement, choisissez Formulaire de modèle d’événement et choisissez la Source d’événement et le Type d’événement. Si vous choisissez Tous les événements comme type d'événement, tous les événements émis par ce AWS service seront conformes à la règle.

      Pour personnaliser le modèle, choisissez Custom pattern (JSON editor) (Modèle personnalisé [éditeur JSON]) et effectuez vos modifications.

    • Pour utiliser un modèle d'événement personnalisé, choisissez Custom pattern (JSON editor) (Modèle personnalisé [éditeur JSON]) et créez votre modèle d'événement.

11. Choisissez Suivant.

12. Pour Types de cibles, choisissez service AWS .

13. Pour Sélectionner une cible, choisissez le AWS service auquel vous souhaitez envoyer des informations en cas de EventBridge détection d'un événement correspondant au modèle d'événement.

14. Les champs affichés varient en fonction du service que vous choisissez. Entrez les informations spécifiques requises pour ce type de cible.

15. Pour de nombreux types de cibles, EventBridge nécessite des autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le rôle IAM nécessaire à l'exécution de votre règle. Effectuez l’une des actions suivantes :

    • Pour créer un rôle IAM automatiquement, sélectionnez Create a new role for this specific resource.

    • Pour utiliser un rôle IAM que vous avez créé précédemment, choisissez Utiliser le rôle existant et sélectionnez le rôle existant dans la liste déroulante.

16. (Facultatif) Pour Additional settings (Paramètres supplémentaires), procédez comme suit :

    1. Pour Maximum age of event (Âge maximal de l'événement), saisissez une valeur comprise entre une minute (00:01) et 24 heures (24:00).

    2. Pour Retry attempts (Nouvelles tentatives), saisissez un nombre compris entre 0 et 185.

    3. Pour la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS standard comme file d'attente de lettres mortes. EventBridge envoie les événements correspondant à cette règle à la file d'attente des lettres mortes s'ils ne sont pas correctement transmis à la cible. Effectuez l’une des actions suivantes :

       • Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.

       • Choisissez Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue (Sélectionner une file d'attente Amazon SQS du compte AWS actuel à utiliser en tant que file d'attente de lettres mortes) et sélectionnez la file d'attente à utiliser dans la liste déroulante.

       • Choisissez Sélectionnez une file d'attente Amazon SQS dans un autre AWS compte en tant que file d'attente de lettres mortes, puis entrez l'ARN de la file d'attente à utiliser. Vous devez associer à la file d'attente une politique basée sur les ressources qui EventBridge autorise l'envoi de messages. Pour plus d’informations, consultez Octroi d’autorisations à la file d’attente de lettres mortes.

17. (Facultatif) Sélectionnez Add another target (Ajouter une autre cible) pour ajouter une nouvelle cible pour cette règle.

18. Choisissez Suivant.

19. (Facultatif) Saisissez une ou plusieurs balises pour la règle. Pour plus d’informations, consultez EventBridge Balises Amazon.

20. Choisissez Suivant.

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