Création d'une règle exécutée selon un calendrier sur Amazon EventBridge - Amazon EventBridge
Création d’une règle qui s’exécute selon un calendrier

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.

Création d'une règle exécutée selon un calendrier sur Amazon EventBridge

Une règle peut être exécutée en réponse à un événement ou à certains intervalles de temps. Par exemple, pour exécuter régulièrement une fonction AWS Lambda , vous pouvez créer une règle à exécuter selon un calendrier.

Note

Bien que vous puissiez créer des règles qui s'exécutent selon un calendrier, offre EventBridge désormais un moyen plus flexible et plus puissant de créer, exécuter et gérer des tâches planifiées de manière centralisée : Planificateur EventBridge. Vous pouvez ainsi créer des plannings à l'aide d'expressions cron et rate pour les modèles récurrents, ou configurer des appels ponctuels. Planificateur EventBridge Vous pouvez configurer des fenêtres temporelles flexibles pour la livraison, définir des limites de nouvelles tentatives et définir la durée de rétention maximale API en cas d'échec des appels.

Le planificateur est hautement personnalisable et offre une évolutivité améliorée par rapport aux règles planifiées, avec un ensemble plus large d'APIopérations et de services cibles. AWS Nous vous recommandons d'utiliser le planificateur pour appeler des cibles selon un calendrier.

Pour plus d’informations, consultez Créer une planification.

Dans EventBridge, vous pouvez créer deux types de règles planifiées :

  • Règles qui s’exécutent à fréquence régulière

    EventBridge exécute ces règles à intervalles réguliers, par exemple toutes les 20 minutes.

    Pour spécifier le taux d’une règle planifiée, vous définissez une valeur de déclenchement.

  • Règles qui s’exécutent à des moments précis

    EventBridge applique ces règles à des heures et à des dates spécifiques, par exemple, à 8 h 00 PSTle premier lundi de chaque mois.

    Pour spécifier l’heure et les dates d’exécution d’une règle planifiée, vous définissez une expression cron.

Les valeurs de déclenchement sont plus simples à définir, tandis que les expressions cron offrent un contrôle détaillé du calendrier. Par exemple, une expression cron vous permet de définir une règle qui s’exécute à une heure spécifiée un certain jour de chaque semaine ou mois. En revanche, les valeurs de déclenchement exécutent une règle à une fréquence standard, par exemple une fois toutes les heures ou une fois par jour.

Tous les événements planifiés utilisent le fuseau horaire UTC +0, et la précision minimale d'un calendrier est d'une minute.

Note

EventBridge ne fournit pas de précision de second niveau dans les expressions de planification. Le niveau de résolution maximal lors de l’utilisation d’une expression cron est d’une minute. En raison de la nature distribuée EventBridge des services cibles, un délai de plusieurs secondes peut s'écouler entre le moment où la règle planifiée est déclenchée et le moment où le service cible exécute la ressource cible.

La vidéo suivante donne un aperçu de la planification des tâches :

Création d’une règle qui s’exécute selon un calendrier

Les étapes suivantes vous expliquent comment créer une EventBridge règle qui s'exécute selon un calendrier régulier.

Note

Vous pouvez uniquement créer des règles planifiées à l’aide du bus d’événements par défaut.

Définition de la règle

Commencez par entrer un nom et une description pour identifier la règle.

Pour définir les détails de la règle

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Règles.

  3. Choisissez Créer une règle.

  4. Entrez un Nom et éventuellement une Description pour la règle.

    Une règle ne peut pas porter le même nom qu'une autre règle du même bus Région AWS d'événements ou du même bus d'événements.

  5. Pour Bus d’évènements, choisissez le bus d’événements par défaut. Vous pouvez uniquement créer des règles planifiées à l’aide du bus d’événements par défaut.

  6. Pour que la règle entre en vigueur dès sa création, assurez-vous que l’option Activer la règle sur le bus d’événements sélectionné est activée.

  7. Pour Rule type (Type de règle), choisissez Schedule (Planifier).

    À ce stade, vous pouvez choisir de continuer à créer une règle qui s'exécute selon un calendrier ou d'utiliser Amazon EventBridge Scheduler.

  8. Choisissez ce que vous souhaitez faire ensuite :

    • Utilisez le EventBridge planificateur pour créer votre emploi du temps

      Note

      EventBridge Le planificateur 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é. Il fournit une fonctionnalité de planification ponctuelle et récurrente indépendamment des bus et des règles d'événement. EventBridge Le planificateur est hautement personnalisable et offre une évolutivité améliorée par rapport aux règles EventBridge planifiées, avec un ensemble plus large d'APIopérations et de services cibles. AWS

      Nous vous recommandons d'utiliser le EventBridge planificateur pour appeler des cibles selon un calendrier. Pour plus d'informations, consultez Qu'est-ce qu'Amazon EventBridge Scheduler ? dans le guide de l'utilisateur d'Amazon EventBridge Scheduler.

      1. Sélectionnez Continuer dans le EventBridge planificateur

        EventBridge ouvre la console du EventBridge planificateur sur la page Créer un calendrier.

      2. Créez le calendrier dans la console du EventBridge planificateur.

    • Continuez EventBridge à utiliser pour créer une règle planifiée pour le bus d'événements par défaut

      1. Sélectionnez Continuer à créer la règle.

Définition du calendrier

Vous allez ensuite définir le modèle de calendrier.

Pour définir le modèle de calendrier

  1. Pour Modèle de planification, choisissez si vous souhaitez exécuter le calendrier à une heure précise ou à une fréquence régulière :

    Specific time

    1. Choisissez Un calendrier détaillé qui s’exécute à une heure précise, à 8 h 00 PSTle premier lundi de chaque mois.

    2. Pour l'expression Cron, spécifiez les champs pour définir l'expression cron qui EventBridge doit être utilisée pour déterminer quand exécuter cette règle planifiée.

      Une fois que vous avez spécifié tous les champs, EventBridge affiche les dix prochaines dates auxquelles cette règle planifiée EventBridge sera exécutée. Vous pouvez choisir d'afficher ces dates dans UTCou dans le fuseau horaire local.

      Pour plus d’informations sur la construction d’une expression cron, consultez Expressions Cron.

    Regular rate

    1. Choisissez Un calendrier qui s’exécute à une fréquence régulière, toutes les 10 minutes par exemple.

    2. Pour Expression du taux, spécifiez les champs Valeur et Unité pour définir le taux auquel cette règle planifiée EventBridge doit être exécutée.

      Pour plus d’informations sur la construction d’une valeur de déclenchement, consultez Expressions de fréquence.

  2. Choisissez Suivant.

Sélection des cibles

Choisissez une ou plusieurs cibles pour recevoir des événements correspondant au modèle spécifié. Les cibles peuvent inclure un bus d' EventBridge événements, des EventBridge API destinations, y compris des partenaires SaaS tels que Salesforce, ou un autre Service AWS.

Pour sélectionner des cibles

  1. Pour Type de cible, choisissez l’un des types de cibles suivants :

    Event bus

    Pour sélectionner un bus d' EventBridge événements, sélectionnez le bus d'EventBridge événements, puis procédez comme suit :

    API destination

    Pour utiliser une EventBridge API destination, EventBridge APIsélectionnez-la, puis effectuez l'une des opérations suivantes :

    • Pour utiliser une API destination existante, sélectionnez Utiliser une API destination existante. Sélectionnez ensuite une API destination dans la liste déroulante.

    • Pour créer une nouvelle API destination, sélectionnez Créer une nouvelle API destination. Fournissez ensuite les informations suivantes pour la destination :

      • Nom : entrez un nom pour la destination.

        Les noms doivent être uniques dans votre Compte AWS. Les noms peuvent comporter jusqu’à 64 caractères. Les caractères valides sont A-Z, a-z, 0-9 et . _ - (tiret).

      • (Facultatif) Description : entrez une description pour la destination.

        Les descriptions peuvent comporter jusqu’à 512 caractères.

      • APIpoint de terminaison de destination : URL point de terminaison de la cible.

        Le point de terminaison URL doit commencer parhttps. Vous pouvez inclure le caractère générique * en tant que paramètre de chemin. Vous pouvez définir les paramètres du chemin à partir de l’attribut HttpParameters de la cible.

      • HTTPméthode — Sélectionnez la HTTP méthode utilisée lorsque vous appelez le point de terminaison.

      • (Facultatif) Limite du taux d’appel par seconde : entrez le nombre maximal d’invocations acceptées par seconde pour cette destination.

        Cette valeur doit être supérieure à zéro. Par défaut, cette valeur est définie sur 300.

      • Connexion : choisissez d’utiliser une connexion nouvelle ou existante :

        • Pour utiliser une connexion existante, sélectionnez Utiliser une connexion existante et sélectionnez la connexion dans la liste déroulante.

        • Pour créer une nouvelle connexion pour cette destination, sélectionnez Créer une nouvelle connexion, puis définissez le Nom, le Type de destination et le Type d’autorisation de la connexion. Vous pouvez également ajouter une Description facultative pour cette connexion.

    Pour plus d’informations, consultez Destinations d'API en tant que cibles sur Amazon EventBridge.

    Service AWS

    Pour utiliser un Service AWS, sélectionnez Service AWS, puis procédez comme suit :

    1. Pour Sélectionner une cible, sélectionnez un Service AWS à utiliser comme cible. Fournissez les informations demandées pour le service que vous sélectionnez.

      Note

      Les champs affichés varient en fonction du service sélectionné. Pour plus d’informations sur les cibles disponibles, consultez Cibles du bus d'événements disponibles dans la EventBridge console.

  2. Pour de nombreux types de cibles, EventBridge nécessite des autorisations pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le IAM rôle nécessaire à l'exécution de votre règle.

    Pour Rôle d’exécution, effectuez l’une des opérations suivantes :

    • Pour créer un nouveau rôle d’exécution pour cette règle :

      1. Sélectionnez Créer un rôle pour cette ressource spécifique.

      2. Entrez un nom pour ce rôle d'exécution ou utilisez le nom généré par EventBridge.

    • Pour utiliser un rôle d’exécution existant pour cette règle :

      1. Sélectionnez Utiliser le rôle existant.

      2. Entrez ou sélectionnez le nom du rôle d’exécution à utiliser dans la liste déroulante.

  3. (Facultatif) Pour Réglages supplémentaires, spécifiez l’un des paramètres facultatifs disponibles pour votre type de cible :

    Event bus

    (Facultatif) Pour la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'SQSattente Amazon standard comme file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente des lettres mortes s'ils ne sont pas correctement transmis à la cible. Effectuez l’une des actions suivantes :

    • Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.

    • Choisissez Sélectionnez une SQS file d'attente Amazon dans le AWS compte courant à utiliser comme file d'attente de lettres mortes, puis sélectionnez la file d'attente à utiliser dans la liste déroulante.

    • Choisissez Sélectionnez une SQS file d'attente Amazon dans un autre AWS compte en tant que file d'attente de lettres mortes, puis saisissez la file ARN d'attente à utiliser. Vous devez associer à la file d'attente une politique basée sur les ressources qui EventBridge autorise l'envoi de messages.

      Pour plus d’informations, consultez Octroi d’autorisations à la file d’attente de lettres mortes.

    API destination

    1. (Facultatif) Pour Configurer l’entrée cible, choisissez la manière dont vous souhaitez personnaliser le texte envoyé à la cible pour les événements correspondants. Sélectionnez l'une des méthodes suivantes :

      • Événements correspondants : EventBridge envoie l'intégralité de l'événement source d'origine à la cible. Il s’agit de l’option par défaut.

      • Une partie des événements correspondants : envoie EventBridge uniquement la partie spécifiée de l'événement source d'origine à la cible.

        Sous Spécifier la partie de l'événement correspondant, spécifiez un JSON chemin qui définit la partie de l'événement que vous EventBridge souhaitez envoyer à la cible.

      • Constante (JSONtexte) — EventBridge envoie uniquement le JSON texte spécifié à la cible. Aucune partie de l’événement source d’origine n’est envoyée.

        Sous Spécifier la constante dans JSON, spécifiez le JSON texte que vous EventBridge souhaitez envoyer à la cible plutôt que l'événement.

      • Transformateur d'entrée — Configurez un transformateur d'entrée pour personnaliser le texte que vous souhaitez EventBridge envoyer à la cible. Pour plus d’informations, consultez Transformation des EventBridge entrées Amazon.

        1. Sélectionnez Configurer le transformateur d’entrée.

        2. Configurez le transformateur d’entrée en suivant les étapes de la rubrique Configuration d'un transformateur d'entrée lors de la création d'une règle dans EventBridge.

    2. (Facultatif) Sous Politique de nouvelle tentative, spécifiez la manière dont vous EventBridge devez réessayer d'envoyer un événement à une cible en cas d'erreur.

      • Âge maximal de l'événement : entrez la durée maximale (en heures, minutes et secondes) pendant EventBridge laquelle les événements non traités sont conservés. La valeur par défaut est 24 heures.

      • Tentatives de nouvelle tentative : entrez le nombre maximum de tentatives d'envoi d'un événement à la cible après qu'une erreur se EventBridge soit produite. La valeur par défaut est 185 fois.

    3. (Facultatif) Pour la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'SQSattente Amazon standard comme file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente des lettres mortes s'ils ne sont pas correctement transmis à la cible. Effectuez l’une des actions suivantes :

      • Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.

      • Choisissez Sélectionnez une SQS file d'attente Amazon dans le AWS compte courant à utiliser comme file d'attente de lettres mortes, puis sélectionnez la file d'attente à utiliser dans la liste déroulante.

      • Choisissez Sélectionnez une SQS file d'attente Amazon dans un autre AWS compte en tant que file d'attente de lettres mortes, puis saisissez la file ARN d'attente à utiliser. Vous devez associer à la file d'attente une politique basée sur les ressources qui EventBridge autorise l'envoi de messages.

        Pour plus d’informations, consultez Octroi d’autorisations à la file d’attente de lettres mortes.

    AWS service

    Notez que tous les champs suivants EventBridge peuvent ne pas être affichés pour un AWS service donné.

    1. (Facultatif) Pour Configurer l’entrée cible, choisissez la manière dont vous souhaitez personnaliser le texte envoyé à la cible pour les événements correspondants. Sélectionnez l'une des méthodes suivantes :

      • Événements correspondants : EventBridge envoie l'intégralité de l'événement source d'origine à la cible. Il s’agit de l’option par défaut.

      • Une partie des événements correspondants : envoie EventBridge uniquement la partie spécifiée de l'événement source d'origine à la cible.

        Sous Spécifier la partie de l'événement correspondant, spécifiez un JSON chemin qui définit la partie de l'événement que vous EventBridge souhaitez envoyer à la cible.

      • Constante (JSONtexte) — EventBridge envoie uniquement le JSON texte spécifié à la cible. Aucune partie de l’événement source d’origine n’est envoyée.

        Sous Spécifier la constante dans JSON, spécifiez le JSON texte que vous EventBridge souhaitez envoyer à la cible plutôt que l'événement.

      • Transformateur d'entrée — Configurez un transformateur d'entrée pour personnaliser le texte que vous souhaitez EventBridge envoyer à la cible. Pour plus d’informations, consultez Transformation des EventBridge entrées Amazon.

        1. Sélectionnez Configurer le transformateur d’entrée.

        2. Configurez le transformateur d’entrée en suivant les étapes de la rubrique Configuration d'un transformateur d'entrée lors de la création d'une règle dans EventBridge.

    2. (Facultatif) Sous Politique de nouvelle tentative, spécifiez la manière dont vous EventBridge devez réessayer d'envoyer un événement à une cible en cas d'erreur.

      • Âge maximal de l'événement : entrez la durée maximale (en heures, minutes et secondes) pendant EventBridge laquelle les événements non traités sont conservés. La valeur par défaut est 24 heures.

      • Tentatives de nouvelle tentative : entrez le nombre maximum de tentatives d'envoi d'un événement à la cible après qu'une erreur se EventBridge soit produite. La valeur par défaut est 185 fois.

    3. (Facultatif) Pour la file d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'SQSattente Amazon standard comme file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente des lettres mortes s'ils ne sont pas correctement transmis à la cible. Effectuez l’une des actions suivantes :

      • Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.

      • Choisissez Sélectionnez une SQS file d'attente Amazon dans le AWS compte courant à utiliser comme file d'attente de lettres mortes, puis sélectionnez la file d'attente à utiliser dans la liste déroulante.

      • Choisissez Sélectionnez une SQS file d'attente Amazon dans un autre AWS compte en tant que file d'attente de lettres mortes, puis saisissez la file ARN d'attente à utiliser. Vous devez associer à la file d'attente une politique basée sur les ressources qui EventBridge autorise l'envoi de messages.

        Pour plus d’informations, consultez Octroi d’autorisations à la file d’attente de lettres mortes.

  4. (Facultatif) Sélectionnez Add another target (Ajouter une autre cible) pour ajouter une nouvelle cible pour cette règle.

  5. Choisissez Suivant.

Configuration des balises et vérification de la règle

Pour finir, entrez les balises de votre choix pour la règle, puis passez en revue et créez la règle.

Pour configurer les balises, vérifier et créer la règle

  1. (Facultatif) Saisissez une ou plusieurs balises pour la règle. Pour plus d’informations, consultez Marquage des ressources sur Amazon EventBridge.

  2. Choisissez Suivant.

  3. Passez en revue les détails de la nouvelle règle. Pour apporter des modifications à une section, choisissez le bouton Modifier en regard de cette section.

    Lorsque vous êtes satisfait des détails de la règle, choisissez Créer une règle.