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 Amazon EventBridge qui s'exécute selon un calendrier
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.
EventBridge propose le planificateur Amazon EventBridge, 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é. Le Planificateur EventBridge est hautement personnalisable et offre une meilleure capacité de mise à l'échelle par rapport aux règles planifiées d'EventBridge, avec un ensemble plus large d'opérations d'API cibles et de services AWS.
Nous vous recommandons d'utiliser le Planificateur EventBridge pour invoquer des cibles selon un calendrier. Pour de plus amples informations, veuillez consulter Utilisation du planificateur Amazon EventBridge avec Amazon EventBridge.
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, toutes les 20 minutes par exemple.
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 exécute ces règles à des heures et à des dates spécifiques, à 8 h 00 PST le premier lundi de chaque mois par exemple.
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 de 1 minute.
EventBridge ne fournit pas de précision de deuxième niveau dans les expressions de calendrier. Le niveau de résolution maximal lors de l'utilisation d'une expression cron est d'une minute. Compte tenu de la nature distribuée d'EventBridge et des services cibles, un décalage de plusieurs secondes peut être observé 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 expliquent comment créer une règle EventBridge qui s'exécute selon un calendrier régulier.
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
Ouvrez la console Amazon EventBridge à l'adresse https://console.aws.amazon.com/events/.
-
Dans le volet de navigation, choisissez Rules.
-
Choisissez Create rule (Créer une règle).
-
Entrez un Nom et éventuellement une Description pour la règle.
Une règle ne peut pas avoir le même nom qu'une autre règle de la même Région AWS et sur le même bus d'événement.
-
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.
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.
-
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 le Planificateur Amazon EventBridge.
-
Choisissez ce que vous souhaitez faire ensuite :
Définition du calendrier
Vous allez ensuite définir le modèle de calendrier.
Pour définir le modèle de calendrier
-
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
-
Choisissez Un calendrier détaillé qui s'exécute à une heure précise, à 8 h 00 PST le premier lundi de chaque mois par exemple.
Pour Expression cron, spécifiez des champs pour définir l'expression cron qu'EventBridge doit utiliser 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 il exécutera cette règle planifiée. Vous pouvez choisir d'afficher ces dates au format UTC ou au Fuseau horaire local.
Pour plus d'informations sur la construction d'une expression cron, consultez Référence des expressions cron.
- Regular rate
-
Choisissez Un calendrier qui s'exécute à une fréquence régulière, toutes les 10 minutes par exemple.
Pour Expression de fréquence, spécifiez les champs Valeur et Unité pour définir la fréquence à laquelle EventBridge doit exécuter cette règle planifiée.
Pour plus d'informations sur la construction d'une valeur de déclenchement, consultez Référence des valeurs de déclenchement.
-
Choisissez Next (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'événements EventBridge, des destinations d'API EventBridge, y compris des partenaires SaaS tels que Salesforce, ou un autre Service AWS.
Pour sélectionner des cibles
-
Pour Type de cible, choisissez l'un des types de cibles suivants :
- Event bus
-
Pour sélectionner un bus d'événements EventBridge, sélectionnez Bus d'événements EventBridge, puis procédez comme suit :
- API destination
-
Pour utiliser une destination d'API EventBridge, sélectionnez Destination d'API EventBridge, puis effectuez l'une des opérations suivantes :
-
Pour utiliser une destination d'API existante, sélectionnez Utiliser une destination d'API existante. Ensuite, sélectionnez une destination d'API dans la liste déroulante.
-
Pour créer une nouvelle destination d'API, sélectionnez Créer une nouvelle destination API. 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.
-
Point de terminaison de la destination d'API : point de terminaison d'URL de la cible.
L'URL du point de terminaison doit commencer par https. 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.
-
Méthode HTTP : sélectionnez la méthode HTTP utilisée lorsque vous invoquez 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 de plus amples informations, veuillez consulter Destinations d’API.
- Service AWS
-
Pour utiliser un Service AWS, sélectionnez Service AWS, puis procédez comme suit :
-
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.
-
Pour de nombreux types de cibles, EventBridge a besoin d'autorisations pour envoyer des événements à la cible. Dans ce cas, EventBridge peut créer le rôle IAM nécessaire à l'exécution de votre règle.
Pour Rôle d'exécution, effectuez l'une des opérations suivantes :
-
(Facultatif) Pour Réglages supplémentaires, spécifiez l'un des paramètres facultatifs disponibles pour votre type de cible :
- Event bus
-
(Facultatif) Pour File d'attente de lettres mortes, indiquez s'il convient d'utiliser une file d'attente Amazon SQS standard en tant que file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente de lettres mortes s'ils ne sont pas correctement remis à la cible. Effectuez l'une des actions suivantes :
-
Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.
-
Choisissez Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue (Sélectionner une file d'attente Amazon SQS du compte AWS actuel à utiliser en tant que file d'attente de lettres mortes) et sélectionnez la file d'attente à utiliser dans la liste déroulante.
-
Choisissez Sélectionner une file d'attente Amazon SQS d'un autre compte AWS en tant que file d'attente de lettres mortes et saisissez l'ARN de la file d'attente à utiliser. Vous devez joindre une stratégie basée sur les ressources à la file d'attente qui accorde l'autorisation EventBridge pour lui envoyer des messages.
Pour de plus amples informations, veuillez consulter Octroi d’autorisations à la file d’attente de lettres mortes.
- API destination
-
-
(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 : EventBridge envoie 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 chemin JSON qui définit la partie de l'événement qu'EventBridge doit envoyer à la cible.
-
Constante (texte JSON) : EventBridge envoie uniquement le texte JSON spécifié à la cible. Aucune partie de l'événement source d'origine n'est envoyée.
Sous Spécifier la constante au format JSON, spécifiez le texte JSON qu'EventBridge doit envoyer à la cible plutôt qu'à l'événement.
-
Transformateur d'entrée : configurez un transformateur d'entrée pour personnaliser le texte qu'EventBridge doit envoyer à la cible. Pour de plus amples informations, veuillez consulter Transformation des EventBridge entrées Amazon.
-
(Facultatif) Sous Politique de nouvelles tentatives, spécifiez la manière dont EventBridge doit réessayer d'envoyer un événement à une cible après qu'une erreur se soit produite.
-
Durée maximale de l'événement : entrez la durée maximale (en heures, minutes et secondes) pendant laquelle EventBridge doit retenir les événements non traités. La valeur par défaut est 24 heures.
-
Nouvelles tentatives : entrez le nombre maximal de fois où EventBridge doit réessayer d'envoyer un événement à la cible après qu'une erreur se soit produite. La valeur par défaut est 185 fois.
-
(Facultatif) Pour File d'attente de lettres mortes, indiquez s'il convient d'utiliser une file d'attente Amazon SQS standard en tant que file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente de lettres mortes s'ils ne sont pas correctement remis à la cible. Effectuez l'une des actions suivantes :
-
Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.
-
Choisissez Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue (Sélectionner une file d'attente Amazon SQS du compte AWS actuel à utiliser en tant que file d'attente de lettres mortes) et sélectionnez la file d'attente à utiliser dans la liste déroulante.
-
Choisissez Sélectionner une file d'attente Amazon SQS d'un autre compte AWS en tant que file d'attente de lettres mortes et saisissez l'ARN de la file d'attente à utiliser. Vous devez joindre une stratégie basée sur les ressources à la file d'attente qui accorde l'autorisation EventBridge pour lui envoyer des messages.
Pour de plus amples informations, veuillez consulter Octroi d’autorisations à la file d’attente de lettres mortes.
- AWS service
-
Notez qu'EventBridge peut ne pas afficher tous les champs suivants pour un service AWS donné.
-
(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 : EventBridge envoie 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 chemin JSON qui définit la partie de l'événement qu'EventBridge doit envoyer à la cible.
-
Constante (texte JSON) : EventBridge envoie uniquement le texte JSON spécifié à la cible. Aucune partie de l'événement source d'origine n'est envoyée.
Sous Spécifier la constante au format JSON, spécifiez le texte JSON qu'EventBridge doit envoyer à la cible plutôt qu'à l'événement.
-
Transformateur d'entrée : configurez un transformateur d'entrée pour personnaliser le texte qu'EventBridge doit envoyer à la cible. Pour de plus amples informations, veuillez consulter Transformation des EventBridge entrées Amazon.
-
(Facultatif) Sous Politique de nouvelles tentatives, spécifiez la manière dont EventBridge doit réessayer d'envoyer un événement à une cible après qu'une erreur se soit produite.
-
Durée maximale de l'événement : entrez la durée maximale (en heures, minutes et secondes) pendant laquelle EventBridge doit retenir les événements non traités. La valeur par défaut est 24 heures.
-
Nouvelles tentatives : entrez le nombre maximal de fois où EventBridge doit réessayer d'envoyer un événement à la cible après qu'une erreur se soit produite. La valeur par défaut est 185 fois.
-
(Facultatif) Pour File d'attente de lettres mortes, indiquez s'il convient d'utiliser une file d'attente Amazon SQS standard en tant que file d'attente de lettres mortes. EventBridge envoie les événements qui correspondent à cette règle à la file d'attente de lettres mortes s'ils ne sont pas correctement remis à la cible. Effectuez l'une des actions suivantes :
-
Choisissez None (Aucune) pour ne pas utiliser de file d'attente de lettres mortes.
-
Choisissez Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue (Sélectionner une file d'attente Amazon SQS du compte AWS actuel à utiliser en tant que file d'attente de lettres mortes) et sélectionnez la file d'attente à utiliser dans la liste déroulante.
-
Choisissez Sélectionner une file d'attente Amazon SQS d'un autre compte AWS en tant que file d'attente de lettres mortes et saisissez l'ARN de la file d'attente à utiliser. Vous devez joindre une stratégie basée sur les ressources à la file d'attente qui accorde l'autorisation EventBridge pour lui envoyer des messages.
Pour de plus amples informations, veuillez consulter Octroi d’autorisations à la file d’attente de lettres mortes.
-
(Facultatif) Sélectionnez Add another target (Ajouter une autre cible) pour ajouter une nouvelle cible pour cette règle.
-
Choisissez Next (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
-
(Facultatif) Saisissez une ou plusieurs balises pour la règle. Pour de plus amples informations, veuillez consulter EventBridge Balises Amazon.
-
Choisissez Next (Suivant).
-
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.
