Démarrage avec Amazon EventBridge - 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.

Démarrage avec Amazon EventBridge

La base de EventBridge c'est créerrèglescette routeévénementsvers uncible. 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, consultezDidacticiels Amazon EventBridge.

Créer une règle dans Amazon EventBridge

Pour créer une règle pour les événements, vous spécifiez une action à effectuer lorsque EventBridge reçoit un événement correspondant au modèle d'événement de la règle. Quand 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'unAWSservice dans votreAWSémet un événement, il accède toujours à la valeur par défautBus d'événementpour votre compte. Pour écrire une règle qui correspond à des événements deAWSdans votre compte, vous devez l'associer au bus d'événement par défaut.

Pour créer une règle pour unAWSservice

  1. Ouvrez l'Amazon EventBridge consolehttps://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Rules.

  3. Choisissez Create rule.

  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. PourBus d'événement, choisissez 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 default event bus (Bus d'événement AWS 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.

  6. PourType de règle, choisissezRègle avec un modèle d'événement.

  7. Choisissez Next (Suivant).

  8. PourOrigine de l'événement, choisissezAWSservices.

  9. (Facultatif) PourExemples d'événements, choisissez le type d'événement.

  10. PourModèle d'événement, effectuez l'une des actions suivantes :

    • Pour utiliser un modèle afin de créer votre modèle d'événement, choisissezFormulaire de modèle d'événementet choisissez leOrigine de l'événementetType d'événement. Si vous choisissezTous les événementscomme type d'événement, tous les événements émis par ceAWSle service correspond à la règle.

      Pour personnaliser le modèle, choisissezModèle personnalisé (éditeur JSON)et apportez vos modifications.

    • Pour utiliser un modèle d'événement personnalisé, choisissezModèle personnalisé (éditeur JSON)et créez votre modèle d'événement.

  11. Choisissez Next (Suivant).

  12. PourTypes de cibles, choisissezAWSservice.

  13. PourSélectionnez une cible, choisissez leAWSservice auquel vous souhaitez envoyer des informations lorsque EventBridge détecte un événement qui correspond au modèle d'événement.

  14. Les champs affichés varient selon le service que vous choisissez. Saisissez des informations spécifiques à ce type de cible, le cas échéant.

  15. Pour de nombreux types de cibles, EventBridge a besoin d'autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge peut 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éé auparavant, choisissezUtiliser un rôle existantet sélectionnez le rôle existant dans la liste déroulante.

  16. (Facultatif) PourParamètres supplémentaires, procédez comme suit :

    1. PourÂge maximum 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. PourFile d'attente de lettres mortes, indiquez si vous souhaitez utiliser une file d'attente Amazon SQS standard en tant que file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente de lettres mortes s'ils ne sont pas correctement remis à 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.

      • ChoisissezSélectionnez une file d'attente Amazon SQS dans une autre file d'attenteAWScompte en tant que file d'attente de lettres mortespuis saisissez l'ARN de la file d'attente à utiliser. Vous devez attacher une stratégie basée sur les ressources à la file d'attente qui accorde EventBridge autorisation de lui envoyer des messages. Pour plus d'informations, consultez Octrois d'autorisations pour la file d'attente de lettres mortes.

  17. (Facultatif) ChoisissezAjout d'une autre ciblepour ajouter une autre cible pour cette règle.

  18. Choisissez Next (Suivant).

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

  20. Choisissez Next (Suivant).

  21. Consultez les détails de la règle et choisissezCréer une règle.