View a markdown version of this page

Invoquer une fonction d'événement Lambda selon un calendrier - AWS Lambda
Configurer le rôle d’exécutionCréation d'un calendrier à partir de la console LambdaAffichage des EventBridge déclencheurs du planificateurRessources 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.

Invoquer une fonction d'événement Lambda selon un calendrier

Amazon EventBridge Scheduler est un planificateur sans serveur que vous pouvez utiliser pour créer, exécuter et 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 d'événement Lambda de EventBridge manière asynchrone. Vous pouvez créer un calendrier à partir de la console Lambda (à l'aide du flux Add trigger), de la console EventBridge Scheduler, du ou. AWS CLI CloudFormation Cette page explique comment utiliser le EventBridge planificateur pour appeler une fonction d'événement Lambda selon un calendrier.

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 Scheduler à 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 créez un planning à l'aide de la console Lambda ou de la console Scheduler, EventBridge EventBridge Scheduler 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 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éation d'un calendrier à partir de la console Lambda

Utilisez le flux Ajouter un déclencheur dans la console Lambda pour créer un calendrier du EventBridge planificateur sans quitter la console.

Pour créer un déclencheur Scheduler à l'aide de la console Lambda

  1. Ouvrez la page Event Functions de la console Lambda.

  2. Choisissez la fonction que vous souhaitez programmer.

  3. Dans le volet de Présentation de la fonction, choisissez Ajouter un déclencheur.

  4. Dans le menu déroulant de la source du déclencheur, choisissez Scheduler.

  5. Configurez les paramètres de planification :

    1. Nom du programme — Entrez le nom de votre programme.

    2. Groupe de planification : choisissez un groupe de planification ou utilisez-ledefault.

    3. Type de programme — Choisissez l'une des options suivantes :

      • One-time schedule — Invoque la fonction une fois à la date et à l'heure spécifiées.

      • Planification récurrente — Invoque la fonction à plusieurs reprises à l'aide d'une expression cron ou rate.

    4. (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.

    5. Configurez le rôle d'exécution. 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 crée une politique avec les autorisations requises et l'attache au rôle.

  6. Choisissez Ajouter.

Astuce

Vous pouvez également rechercherschedule, crontime, ou recurring trouver ce déclencheur dans le flux Ajouter un déclencheur.

Vous pouvez également utiliser la console du EventBridge planificateur pour créer un calendrier. Avec la console EventBridge Scheduler, vous pouvez configurer des options supplémentaires telles que des fenêtres horaires flexibles et des files d'attente de lettres mortes.

Affichage des EventBridge déclencheurs du planificateur

Tous les plannings du EventBridge planificateur ciblant votre fonction apparaissent dans la section Déclencheurs de la page de configuration des fonctions, sous l'étiquette Scheduler. Cela inclut les plannings créés à partir de l'une des sources suivantes :

  • La console Lambda (Ajouter un flux de déclencheurs)

  • La console du EventBridge planificateur

  • Le SDK AWS CLI, CloudFormation, AWS SAM (en utilisant le type d'ScheduleV2événement) ou AWS CDK (en utilisant le aws-scheduler module)

Note

Si un planning utilise une clé gérée par le client pour le chiffrement avec une cible Universal Target Invocation (UTI), il se peut qu'elle n'apparaisse pas dans la liste des déclencheurs. Pour consulter ces plannings, utilisez la console du EventBridge planificateur.

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 :