

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
<a name="with-eventbridge-scheduler"></a>

Le [planificateur Amazon EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html) 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 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 planificateur EventBridge avec Lambda, le planificateur EventBridge invoque votre fonction Lambda de manière asynchrone. Cette page explique comment utiliser le planificateur EventBridge pour invoquer une fonction Lambda dans une planification.

## Configurer le rôle d’exécution
<a name="using-eventbridge-scheduler-execution-role"></a>

 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 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](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html#setting-up-execution-role) dans le *Guide de l’utilisateur du planificateur EventBridge*. 

## Créer une planification
<a name="using-eventbridge-scheduler-create"></a>

**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](https://console.aws.amazon.com/scheduler/home/).

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

1.  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**. 

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

   1. 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. 

   1. Choisissez vos options de planification.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lambda/latest/dg/with-eventbridge-scheduler.html)

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

   1. 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. 

   1. 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. 

1. Choisissez **Suivant**. 

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

   1. Sélectionnez **Invoquer AWS Lambda**.

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

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

1. Choisissez **Suivant**. 

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

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

   1. 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.

   1. Choisissez où le planificateur EventBridge stocke les événements non livrés.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/lambda/latest/dg/with-eventbridge-scheduler.html)

   1. 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 key**pour 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](https://docs.aws.amazon.com/scheduler/latest/UserGuide/encryption-rest.html) dans le *Guide de l’utilisateur du planificateur Amazon EventBridge*. 

   1. 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.

1. Choisissez **Suivant**. 

1.  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. 

1. 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 le planificateur EventBridge a invoqué la fonction, [consultez les Amazon CloudWatch Logs de la fonction](monitoring-cloudwatchlogs-view.md#monitoring-cloudwatchlogs-console).

## Ressources connexes
<a name="using-eventbridge-scheduler-related-resources"></a>

 Pour de plus amples informations sur le planificateur EventBridge, veuillez consulter les ressources suivantes : 
+ [Guide de l’utilisateur du planificateur EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)
+ [Référence de l’API du planificateur EventBridge](https://docs.aws.amazon.com/scheduler/latest/APIReference/Welcome.html)
+ [Tarification du planificateur EventBridge](https://aws.amazon.com/eventbridge/pricing/#Scheduler)