View a markdown version of this page

Invocation d’une fonction Lambda dans une planification - 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.

Invocation d’une fonction Lambda dans une planification

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 EventBridge Scheduler avec Lambda, EventBridge Scheduler appelle votre fonction Lambda de manière asynchrone. Vous pouvez créer un calendrier depuis la console Lambda (à l'aide du flux de déclenchement Ajouter), la console EventBridge Scheduler AWS CLI, ou. CloudFormation Cette page explique comment utiliser EventBridge Scheduler pour invoquer une fonction Lambda selon un calendrier.

Configurer le rôle d’exécution

Lorsque vous créez un nouveau calendrier, le EventBridge planificateur doit être autorisé à invoquer 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 EventBridge Scheduler doit invoquer.

Lorsque vous créez un calendrier à l'aide de la console Lambda ou de la console EventBridge Scheduler, 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 kits SDK du EventBridge AWS CLI planificateur CloudFormation, vous devez disposer d'un rôle d'exécution existant qui accorde les autorisations requises par le EventBridge planificateur pour invoquer une cible. Pour plus d'informations sur la configuration manuelle d'un rôle d'exécution pour votre planification, 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 de déclenchement Add dans la console Lambda pour créer un planning EventBridge Scheduler sans quitter la console.

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

  1. Ouvrez la page Functions (Fonctions) 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 la liste déroulante de la source du déclencheur, choisissez Scheduler.

  5. Configurez les paramètres de planification :

    1. Nom de l'horaire — Entrez un nom pour votre programme.

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

    3. Type de planification — 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 ne saisissez pas de charge utile, EventBridge Scheduler 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'associe 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 EventBridge Scheduler pour créer un calendrier. La console EventBridge Scheduler vous permet de configurer des options supplémentaires, telles que des fenêtres horaires flexibles et des files d'attente aux lettres mortes.

Affichage des EventBridge déclencheurs du planificateur

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

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

  • La console EventBridge Scheduler

  • 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 calendrier utilise une clé gérée par le client pour le chiffrement avec une cible Universal Target Invocation (UTI), elle risque de ne pas apparaître dans la liste des déclencheurs. Pour consulter ces planifications, utilisez la console EventBridge Scheduler.

Pour vérifier que le EventBridge planificateur a invoqué la fonction, consultez les CloudWatch journaux Amazon de la fonction.

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