Utilisation du planificateur Amazon EventBridge avec Amazon EventBridge

Le planificateur Amazon EventBridge est un planificateur sans serveur qui vous permet de créer, d'exécuter et de gérer des tâches à partir d'un service central et géré. Avec le planificateur EventBridge, vous pouvez créer des planifications à l'aide d'expressions cron et rate pour les modèles récurrents, voire configurer des invocations ponctuelles. Vous pouvez configurer des fenêtres de temps flexibles pour la livraison, définir des limites de nouvelles tentatives ainsi que la durée de conservation maximale pour les invocations d'API en échec.

Le Planificateur EventBridge est hautement personnalisable et offre une meilleure capacité de mise à l'échelle par rapport aux règles planifiées d'EventBridge, avec un ensemble plus large d'opérations d'API cibles et de services AWS. Nous vous recommandons d'utiliser le Planificateur EventBridge pour invoquer des cibles selon un calendrier.

Configurer le rôle d'exécution

Lorsque vous créez une planification, le planificateur EventBridge doit être autorisé à invoquer son opération d'API cible en votre nom. Vous accordez ces autorisations au planificateur EventBridge à l'aide d'un rôle d'exécution. La politique d'autorisation que vous associez au rôle d'exécution de votre planification définit les autorisations requises. Ces autorisations dépendent de l'API cible que vous souhaitez que le planificateur EventBridge invoque.

Lorsque vous utilisez la console du planificateur EventBridge pour créer une planification, comme dans la procédure suivante, le planificateur EventBridge définit automatiquement un rôle d'exécution en fonction de la cible que vous avez sélectionnée. Si vous souhaitez créer une planification à l'aide de l'un des kits SDK du planificateur EventBridge, de la AWS CLI ou de AWS CloudFormation, vous devez disposer d'un rôle d'exécution existant qui accorde les autorisations dont le planificateur EventBridge a besoin pour invoquer une cible. Pour plus d'informations sur la configuration manuelle d'un rôle d'exécution pour votre planification, voir Configuration d'un rôle d'exécution dans le Guide de l'utilisateur du planificateur EventBridge.

Créer une planification

Pour créer une planification à l'aide de la console

1. Ouvrez la console du planificateur Amazon EventBridge à l'adresse https://console.aws.amazon.com/scheduler/home.

2. Sur la page Planifications, choisissez Créer une planification.

3. Sur la page Spécifier le détail de la planification, dans la section Nom et description de la planification, procédez comme suit :

   1. Pour Nom de la planification, saisissez un nom à attribuer à votre planification. Par exemple, MyTestSchedule.

   2. (Facultatif) Dans le champ Description, saisissez une description de la planification. Par exemple, My first schedule.

   3. Pour Groupe de planifications, choisissez un groupe de planifications dans la liste déroulante. Si vous n'avez pas de groupe, choisissez par défaut. Pour créer un groupe de planifications, choisissez Crée votre propre planification.

      Vous utilisez des groupes de planifications pour leur ajouter des balises.

4. 1. Choisissez vos options de planification.

      Occurrence	Faites ceci...
      Planification ponctuelle Une planification ponctuelle n'invoque un objectif qu'une seule fois à la date et à l'heure que vous indiquez.	Pour Date et heure, procédez comme suit : Entrez une date valide au format YYYY/MM/DD. Entrez un horodatage au format hh:mm de 24 heures. Dans le champ Fuseau horaire, choisissez le fuseau horaire.
      Planification récurrente Une planification récurrente invoque un objectif à un taux que vous spécifiez à l'aide d'une expression cron ou d'une expression rate.	Pour Schedule type (Planifier le type), effectuez l'une des étapes suivantes : Pour utiliser une expression cron afin de définir la planification, choisissez Planification basée sur cron et entrez l’expression cron. Pour utiliser une expression de rythme pour définir la planification, choisissez Planification basée sur le rythme. Pour plus d'informations sur les expressions cron et rate, consultez Types de planifications sur le planificateur EventBridge dans le Guide de l'utilisateur du planificateur Amazon EventBridge. Pour Fenêtre temporelle flexible, choisissez Désactivé pour désactiver cette option ou choisir l'une des fenêtres temporelles prédéfinies. Par exemple, si vous choisissez15 minutes et que vous définissez une planification récurrente pour invoquer son objectif une fois par heure, la planification s'exécute dans les 15 minutes suivant le début de chaque heure.

5. (Facultatif) Si vous avez choisi Planification récurrente à l'étape précédente, dans la section Délai, procédez comme suit :

   1. Dans le champ Fuseau horaire, choisissez un fuseau horaire.

   2. Pour Date et heure de début, entrez une date valide au format YYYY/MM/DD, puis spécifiez un horodatage au format hh:mm de 24 heures.

   3. Pour Date et heure de fin, entrez une date valide au format YYYY/MM/DD, puis spécifiez un horodatage au format hh:mm de 24 heures.

6. Choisissez Next (Suivant).

7. Sur la page Sélectionner la cible, choisissez l'opération d'API AWS invoquée par le planificateur EventBridge :

   1. Pour API de la cible, choisissez Cibles modélisées.

   2. Choisissez Événements Put Amazon EventBridge.

   3. Sous Événements Put, spécifiez ce qui suit :

      • Pour Bus d'événements EventBridge, choisissez le bus d'événements dans le menu déroulant. Par exemple, default.

        Vous pouvez également créer un bus d'événements dans la console EventBridge en choisissant Créer un nouveau bus d'événements.

      • Pour Detail-type, entrez le type de détail des événements qui doivent correspondre. Par exemple, Object Created.

      • Dans Source, entrez le nom du service qui correspond à la source des événements.

        Pour les événements d'un service AWS, spécifiez le préfixe du service en guise de source. N'incluez pas le préfixe aws.. Par exemple, pour les événements Amazon S3, entrez s3.

        Pour déterminer le préfixe d'un service, consultez le tableau des clés de condition dans le guide de référence de l'autorisation de service. Pour plus d'informations sur les valeurs source et detail-type des événements, consultez Référence sur la structure des événements.

      • (Facultatif) Pour detail, entrez un modèle d'événement pour filtrer davantage les événements que le planificateur EventBridge envoie à EventBridge.

        Pour de plus amples informations, veuillez consulter Modèles d' EventBridge événements Amazon.

8. Choisissez Next (Suivant).

9. Sur la page Settings (Paramètres), procédez comme suit :

   1. Pour activer la planification, sous État de la planification, activez Activer la planification.

   2. Pour configurer une stratégie de nouvelles tentatives pour votre planification, sous Politique de nouvelle tentative et file d'attente de lettres mortes (DLQ), procédez comme suit :

      • Activez Réessayer.

      • Pour Âge maximum de l'événement, entrez le nombre maximum d'heures et de minutes de conservation d'un événement non traité par le planificateur EventBridge.

      • La durée maximale est 24 heures.

      • Pour Nombre maximum de tentatives, entrez le nombre maximum de tentatives de renvoi d'une erreur par le planificateur EventBridge.

        La valeur maximale est 185 nouvelles tentatives.

      Avec les stratégies de nouvelles tentatives, si une planification ne parvient pas à invoquer sa cible, le planificateur EventBridge la réexécute. Si elle est configurée, vous devez définir la durée de rétention maximale et les nouvelles tentatives pour la planification.

   3. Choisissez où le planificateur EventBridge stocke les événements non livrés.

      Option File d'attente de lettres mortes (DLQ)	Faites ceci...
      Ne stockez pas	Sélectionnez Aucun.
      Stocker l'événement dans le même Compte AWS où vous créez la planification	Choisissez Sélectionnez une file d'attente Amazon SQS dans mon Compte AWS en tant que DLQ. Choisissez l'Amazon Resource Name (ARN) de la file d'attente Amazon SQS.
      Stocker l'événement dans un autre Compte AWS que celui où vous créez la planification	Choisissez Spécifier une file d'attente Amazon SQS dans un autre Comptes AWS en tant que DLQ. Entrez l'Amazon Resource Name (ARN) de la file d'attente Amazon SQS.

   4. Pour utiliser une clé gérée par le client afin de chiffrer votre entrée cible, sous Chiffrement, choisissez Personnaliser les paramètres de chiffrement (avancé).

      Si vous choisissez cette option, entrez un ARN de clé KMS existant ou choisissez Créez un AWS KMS keypour accéder à la console AWS KMS. Pour plus d'informations sur la façon dont le planificateur EventBridge chiffre vos données au repos, voir Chiffrement au repos dans le Guide de l'utilisateur du planificateur Amazon EventBridge.

   5. Pour que le planificateur EventBridge crée un rôle d'exécution pour vous, choisissez Créer un rôle pour cette planification. Ensuite, saisissez un nom pour Nom du rôle. Si vous choisissez cette option, le planificateur EventBridge associe au rôle les autorisations requises pour votre cible modélisée.

10. Choisissez Next (Suivant).

11. Sur la page Examiner et créer une planification, examinez les détails de votre planification. Dans chaque section, choisissez Modifier pour revenir à cette étape et modifier ses détails.

12. Choisissez Créer une planification.

    Vous pouvez consulter la liste de vos planifications nouvelles et existantes sur la page Planifications. Sous la colonne État, vérifiez que votre nouvelle planification est activée.

Ressources connexes

Pour de plus amples informations sur le planificateur EventBridge, veuillez consulter les ressources suivantes :

• Guide de l'utilisateur du planificateur EventBridge

• Référence de l'API du planificateur EventBridge

• Tarification du planificateur EventBridge