Création d'un AmazonEventBridgerègle exécutée selon un calendrier - Amazon EventBridge
Création d'une règle exécutée 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'un AmazonEventBridgerègle exécutée selon un calendrier

UNrèglepeut être exécuté en réponse à unévénement, ou à certains intervalles de temps. Par exemple, pour exécuter régulièrement unAWS Lambdafonction, vous pouvez créer une règle à exécuter selon un calendrier.

Note

EventBridgeoffres AmazonEventBridgeScheduler, 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é. EventBridgeLe planificateur est hautement personnalisable et offre une évolutivité améliorée par rapport àEventBridgedes règles planifiées, avec un ensemble plus large d'opérations d'API cibles etAWSservices.

Nous vous recommandons d'utiliserEventBridgePlanificateur pour invoquer des cibles selon un calendrier. Pour plus d'informations, consultez leAmazonEventBridgeGuide de l'utilisateur du planificateur.

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

  • Des règles qui s'appliquent à un rythme régulier

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

    Pour définir le taux d'une règle planifiée, vous définissez unexpression du taux.

  • Des règles qui s'appliquent à des moments précis

    EventBridgeapplique ces règles à des heures et à des dates spécifiques, par exemple à 8 h 00. PST le 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 unexpression cron.

Les expressions de taux sont plus simples à définir, tandis que les expressions cron offrent un contrôle détaillé de la planification. Par exemple, avec une expression cron, vous pouvez définir une règle qui s'exécute à une heure précise un certain jour de chaque semaine ou de chaque mois. En revanche, les expressions de taux exécutent une règle à un rythme régulier, par exemple une fois par heure 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 deuxième niveau dans les expressions de planification. La meilleure résolution avec une expression cron est d'une minute. En raison de la nature distribuée deEventBridgeet les services cibles, il peut y avoir un délai de plusieurs secondes 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 :

Rubriques

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

Les étapes suivantes vous expliquent comment créer unEventBridgerègle qui fonctionne selon un calendrier régulier.

Note

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

Définissez la règle

Entrez d'abord un nom et une description pour votre règle afin de l'identifier.

Pour définir le détail de la règle

  1. Ouvrez l'AmazonEventBridgeconsole àhttps://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Rules.

  3. Choisissez Create rule (Créer une règle).

  4. Entrez unNomet, éventuellement, unDescriptifpour 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.

  5. PourBus événementiel, choisissez le bus d'événements par défaut. Vous ne pouvez créer des règles planifiées qu'à 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 queActiver la règle sur le bus d'événements sélectionnél'option 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 AmazonEventBridgePlanificateur.

  8. Choisissez la manière dont vous souhaitez continuer :

    • UtiliserEventBridgePlanificateur pour créer votre planning

      Note

      EventBridgeLe 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 de l'événement. EventBridgeLe planificateur est hautement personnalisable et offre une évolutivité améliorée par rapport àEventBridgedes règles planifiées, avec un ensemble plus large d'opérations d'API cibles etAWSservices.

      Nous vous recommandons d'utiliserEventBridgePlanificateur pour invoquer des cibles selon un calendrier. Pour plus d'informations, voirQu'est-ce qu'AmazonEventBridgePlanificateur ?dans leAmazonEventBridgeGuide de l'utilisateur du planificateur.

      1. SélectionnezContinuez dansEventBridgePlanificateur

        EventBridgeouvre leEventBridgeConsole du planificateur pour leCréation d'un calendrierpage.

      2. Créez le calendrierdans leEventBridgeConsole du planificateur.

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

      1. SélectionnezContinuer à créer une règle.

Définissez le calendrier

Définissez ensuite le modèle de planification.

Pour définir le modèle de planification

  1. PourSchéma de planification, choisissez si vous souhaitez que le programme soit diffusé à une heure précise ou à un rythme régulier :

    Specific time

    1. ChoisissezUn horaire précis qui fonctionne à une heure précise, par exemple à 8 h 00. PST le premier lundi de chaque mois.

    2. PourExpression Cron, spécifiez les champs pour définir l'expression cron quiEventBridgedoit être utilisé pour déterminer à quel moment exécuter cette règle planifiée.

      Une fois que vous avez spécifié tous les champs,EventBridgeaffiche les dix prochaines dates oùEventBridgeexécutera cette règle planifiée. Vous pouvez choisir d'afficher ou non ces dates dansUTCouFuseau horaire local.

      Pour plus d'informations sur la création d'une expression cron, voirRéférence des expressions Cron.

    Regular rate

    1. ChoisissezUn horaire qui fonctionne à un rythme régulier, par exemple toutes les 10 minutes.

    2. PourExpression du taux, spécifiezValeuretUnitéchamps pour définir le taux auquelEventBridgedoit exécuter cette règle planifiée.

      Pour plus d'informations sur la création d'une expression de taux, voirRéférence des expressions de taux.

  2. Choisissez Suivant.

Sélectionnez les cibles

Choisissez une ou plusieurs cibles pour recevoir des événements correspondant au modèle spécifié. Les cibles peuvent inclure unEventBridgebus événementiel,EventBridgeDestinations d'API, y compris les partenaires SaaS tels que Salesforce ou un autreService AWS.

Pour sélectionner des cibles

  1. PourType de cible, choisissez l'un des types de cibles suivants :

    Event bus

    Pour sélectionner unEventBridgebus d'événements, sélectionnezEventBridgebus événementiel, puis procédez comme suit :

    API destination

    Pour utiliser unEventBridgeDestination de l'API, sélectionnezEventBridgeDestination de l'API, puis effectuez l'une des opérations suivantes :

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

    • Pour créer une nouvelle destination d'API, sélectionnezCréation d'une nouvelle destination d'API. Fournissez ensuite les informations suivantes pour la destination :

      • Nom— Entrez le nom de la destination.

        Les noms doivent être uniques au sein de votreCompte AWS. Les noms peuvent comporter jusqu'à 64 caractères. Les caractères valides sontA-Z,a-z,0-9, et. _ -(trait d'union).

      • (Facultatif)Descriptif— Entrez une description pour la destination.

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

      • Point de terminaison de l'API— Le point de terminaison de l'URL de la cible.

        L'URL du point de terminaison doit commencer parhttps. Vous pouvez inclure le*en tant que caractère générique de paramètre de chemin. Vous pouvez définir les paramètres du chemin à partir de ceux de la cibleHttpParametersattribut.

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

      • (Facultatif)Limite du taux d'invocation par seconde— Entrez le nombre maximum 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.

      • Raccordement— Choisissez d'utiliser une connexion nouvelle ou existante :

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

        • Pour créer une nouvelle connexion pour cette destination, sélectionnezCréation d'une nouvelle connexion, puis définissez la connexionNom,Type de destination, etType d'autorisation. Vous pouvez également ajouter une optionDescriptifpour cette connexion.

    Pour plus d'informations, veuillez consulter Destinations de l'API.

    Service AWS

    Pour utiliser unService AWS, sélectionnezService AWS, puis procédez comme suit :

    1. PourSélectionnez une cible, sélectionnez unService 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, voirCibles disponibles dansEventBridgeconsole.

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

    PourRô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électionnezCréer un nouveau 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é parEventBridge.

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

      1. SélectionnezUtiliser 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) PourRéglages supplémentaires, spécifiez l'un des paramètres facultatifs disponibles pour votre type de cible :

    Event bus

    (Facultatif) PourFile d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS standard comme file d'attente contenant des lettres mortes. EventBridgeenvoie 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 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 associer une politique basée sur les ressources à la file d'attente qui accordeEventBridgeautorisation de lui envoyer des messages.

      Pour plus d'informations, veuillez consulter Accorder des autorisations d'accès à la file d'attente de lettres mortes.

    API destination

    1. (Facultatif) Dans Configurer la saisie 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—EventBridgeenvoie l'intégralité de l'événement source d'origine à la cible. Il s'agit de l'option par défaut.

      • Fait partie des événements correspondants—EventBridgeenvoie uniquement la partie spécifiée de l'événement source d'origine à la cible.

        En dessousSpécifiez la partie de l'événement correspondant, spécifiez un chemin JSON qui définit la partie de l'événement que vous souhaitezEventBridgeà envoyer à la cible.

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

        En dessousSpécifiez la constante en JSON, spécifiez le texte JSON que vous souhaitezEventBridgeà envoyer à la cible plutôt qu'à l'événement.

      • Transformateur d'entrée— Configurez un transformateur d'entrée pour personnaliser le texte que vous souhaitezEventBridgeenvoyer à la cible. Pour plus d'informations, veuillez consulter AmazonEventBridgetransformation d'entrée.

        1. SélectionnezConfigurer le transformateur d'entrée.

        2. Configurez le transformateur d'entrée en suivant les étapes décrites dansConfiguration d'un transformateur d'entrée dans le cadre de la création d'une règle.

    2. (Facultatif) SousPolitique relative aux nouvelles tentatives, précisez commentEventBridgedevrait réessayer d'envoyer un événement à une cible après qu'une erreur se soit produite.

      • Âge maximum de l'événement— Entrez la durée maximale (en heures, minutes et secondes) pourEventBridgepour conserver les événements non traités. La valeur par défaut est de 24 heures.

      • Tentatives de nouvelle tentative— Entrez le nombre maximum de foisEventBridgedevrait 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.

    3. (Facultatif) PourFile d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS standard comme file d'attente contenant des lettres mortes. EventBridgeenvoie 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 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 associer une politique basée sur les ressources à la file d'attente qui accordeEventBridgeautorisation de lui envoyer des messages.

        Pour plus d'informations, veuillez consulter Accorder des autorisations d'accès à la file d'attente de lettres mortes.

    AWS service

    Notez queEventBridgepeut ne pas afficher tous les champs suivants pour une donnéeAWSservice.

    1. (Facultatif) Dans Configurer la saisie 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—EventBridgeenvoie l'intégralité de l'événement source d'origine à la cible. Il s'agit de l'option par défaut.

      • Fait partie des événements correspondants—EventBridgeenvoie uniquement la partie spécifiée de l'événement source d'origine à la cible.

        En dessousSpécifiez la partie de l'événement correspondant, spécifiez un chemin JSON qui définit la partie de l'événement que vous souhaitezEventBridgeà envoyer à la cible.

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

        En dessousSpécifiez la constante en JSON, spécifiez le texte JSON que vous souhaitezEventBridgeà envoyer à la cible plutôt qu'à l'événement.

      • Transformateur d'entrée— Configurez un transformateur d'entrée pour personnaliser le texte que vous souhaitezEventBridgeenvoyer à la cible. Pour plus d'informations, veuillez consulter AmazonEventBridgetransformation d'entrée.

        1. SélectionnezConfigurer le transformateur d'entrée.

        2. Configurez le transformateur d'entrée en suivant les étapes décrites dansConfiguration d'un transformateur d'entrée dans le cadre de la création d'une règle.

    2. (Facultatif) SousPolitique relative aux nouvelles tentatives, précisez commentEventBridgedevrait réessayer d'envoyer un événement à une cible après qu'une erreur se soit produite.

      • Âge maximum de l'événement— Entrez la durée maximale (en heures, minutes et secondes) pourEventBridgepour conserver les événements non traités. La valeur par défaut est de 24 heures.

      • Tentatives de nouvelle tentative— Entrez le nombre maximum de foisEventBridgedevrait 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.

    3. (Facultatif) PourFile d'attente de lettres mortes, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS standard comme file d'attente contenant des lettres mortes. EventBridgeenvoie 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 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 associer une politique basée sur les ressources à la file d'attente qui accordeEventBridgeautorisation de lui envoyer des messages.

        Pour plus d'informations, veuillez consulter Accorder des autorisations d'accès à 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 des règles de révision

Enfin, entrez les balises souhaitées 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, veuillez consulter Amazon EventBridge balises.

  2. Choisissez Next (Suivant).

  3. Passez en revue les détails de la nouvelle règle. Pour apporter des modifications à une section, choisissez leModifierbouton à côté de cette section.

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