Utilisation de Lambda avec Amazon Scheduler EventBridge - AWS Lambda
Configurer le rôle d'exécutionCréer une planificationRessources connexes

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.

Utilisation de Lambda avec Amazon Scheduler EventBridge

Amazon EventBridge Scheduler 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 géré centralisé. Avec EventBridge Scheduler, vous pouvez créer des plannings à l'aide d'expressions cron et rate pour les modèles récurrents, ou configurer des appels ponctuels. Vous pouvez configurer des fenêtres temporelles flexibles pour la livraison, définir des limites de nouvelles tentatives, ainsi que la durée de rétention maximale pour les événements non traités.

Lorsque vous configurez le EventBridge planificateur avec Lambda, le planificateur appelle votre fonction Lambda de EventBridge manière asynchrone. Cette page explique comment utiliser le EventBridge Scheduler pour appeler une fonction Lambda dans un planning.

Configurer le rôle d'exécution

Lorsque vous créez un nouveau calendrier, le EventBridge planificateur doit être autorisé à appeler son opération d'API cible en votre nom. Vous accordez ces autorisations au EventBridge planificateur à 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 le EventBridge Scheduler doit appeler.

Lorsque vous utilisez la console du EventBridge planificateur pour créer un calendrier, comme dans la procédure suivante, le EventBridge planificateur 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 un calendrier à l'aide de l'un des SDK du EventBridge planificateur AWS CloudFormation, vous devez disposer d'un rôle d'exécution existant qui accorde les autorisations dont le EventBridge planificateur a besoin pour appeler une cible. AWS CLI Pour plus d'informations sur la configuration manuelle d'un rôle d'exécution pour votre calendrier, consultez la section Configuration d'un rôle d'exécution dans le guide de l'utilisateur du EventBridge planificateur.

Créer une planification

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

  1. Ouvrez la console Amazon EventBridge Scheduler à 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.

    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.

      1. Pour Schedule type (Planifier le type), effectuez l'une des étapes suivantes :

      2. 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 Suivant.

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

    1. Sélectionnez Invoquer AWS Lambda .

    2. Dans la section Invoquer, sélectionnez une fonction ou choisissez Créer une fonction Lambda.

    3. (Facultatif) Entrez une charge utile JSON. Si vous n'entrez aucune charge utile, le EventBridge planificateur utilise un événement vide pour appeler la fonction.

  8. Choisissez 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 maximal de l'événement, entrez le nombre maximum d'heures et de minutes pendant lequel le EventBridge planificateur doit conserver un événement non traité.

      • La durée maximale est 24 heures.

      • Pour Nombre maximum de tentatives, entrez le nombre maximum de fois que le EventBridge planificateur réessaie le calendrier si la cible renvoie une erreur.

        La valeur maximale est 185 nouvelles tentatives.

      Avec les politiques de nouvelle tentative, si un calendrier ne parvient pas à invoquer sa cible, le EventBridge planificateur le 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 l'endroit où EventBridge Scheduler stocke les événements non livrés.

      Option File d'attente de lettres mortes (DLQ) Faites ceci...
      Ne stockez pas Sélectionnez Aucun.
      Enregistrez l'événement dans le même Compte AWS endroit où vous créez le calendrier

      1. Choisissez Sélectionnez une file d'attente Amazon SQS dans my Compte AWS as a DLQ.

      2. Choisissez l'Amazon Resource Name (ARN) de la file d'attente Amazon SQS.

      Stockez l'événement dans un endroit Compte AWS différent de celui dans lequel vous créez le calendrier

      1. Choisissez Spécifier une file d'attente Amazon SQS dans un autre en Comptes AWS tant que DLQ.

      2. 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 manière dont EventBridge Scheduler chiffre vos données au repos, consultez la section Chiffrement au repos dans le guide de l'utilisateur d'Amazon EventBridge Scheduler.

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

  10. Choisissez 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.

Pour confirmer que EventBridge Scheduler a invoqué la fonction, consultez les journaux Amazon CloudWatch de la fonction.

Pour plus d'informations sur le EventBridge planificateur, consultez les rubriques suivantes :