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.
# AWS Batch les emplois en tant que EventBridge cibles
Amazon EventBridge fournit un flux d'événements système en temps quasi réel décrivant les modifications apportées aux ressources Amazon Web Services. Généralement, AWS Batch sur Amazon Elastic Container Service, Amazon Elastic Kubernetes Service AWS et Fargate, les jobs sont disponibles en tant que cibles. EventBridge À l'aide de règles simples, vous pouvez faire correspondre les événements et soumettre AWS Batch des offres d'emploi en réponse à ces événements. Pour plus d'informations, voir [Qu'est-ce que c'est EventBridge ?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Vous pouvez également l'utiliser EventBridge pour planifier des actions automatisées qui sont invoquées à certains moments à l'aide **cron** ou à l'évaluation d'expressions. Pour plus d'informations, consultez [la section Création d'une EventBridge règle Amazon exécutée selon un calendrier](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Pour plus d'informations sur la création d'une règle qui s'exécute lorsqu'un événement correspond à un modèle d'événement, consultez la section [Création de EventBridge règles Amazon qui réagissent aux événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Les cas d'utilisation courants des AWS Batch jobs en tant que EventBridge cible incluent les cas d'utilisation suivants :
+ Une tâche planifiée est exécutée à intervalles réguliers. Par exemple, une **cron** tâche est exécutée uniquement pendant les heures de faible utilisation, lorsque les instances Amazon EC2 Spot sont moins chères.
+ Une AWS Batch tâche s'exécute en réponse à une opération d'API connectée CloudTrail. Par exemple, une tâche est soumise chaque fois qu'un objet est chargé dans un compartiment Amazon S3 spécifié. Chaque fois que cela se produit, le transformateur EventBridge d'entrée transmet le nom du compartiment et de la clé de l'objet aux AWS Batch paramètres.
**Note**
Dans ce scénario, toutes les AWS ressources associées doivent se trouver dans la même région. Cela inclut des ressources telles que le compartiment, la EventBridge règle et les CloudTrail journaux Amazon S3.
Avant de pouvoir soumettre AWS Batch des tâches avec des EventBridge règles et des cibles, le EventBridge service a besoin de plusieurs autorisations pour exécuter AWS Batch des tâches. Lorsque vous créez une règle dans la EventBridge console qui spécifie une AWS Batch tâche comme cible, vous pouvez également créer ce rôle. Pour en savoir plus sur le principal de service et les autorisations IAM nécessaires pour ce rôle, consultez [EventBridge Rôle IAM](CWE_IAM_role.md).
**Topics**
+ [Tutoriel : Création d'une AWS Batch tâche planifiée](scheduled-batch-job.md)
+ [Tutoriel : Création d'une règle avec un modèle d'événement](event-pattern-batch-job.md)
+ [Tutoriel : Transmettre les informations d'un événement à une AWS Batch cible selon un calendrier à l'aide du transformateur EventBridge d'entrée](cwe-input-transformer.md)
# Tutoriel : Création d'une AWS Batch tâche planifiée
La procédure suivante explique comment créer une AWS Batch tâche planifiée et le rôle EventBridge IAM requis.
**Pour créer une AWS Batch tâche planifiée avec EventBridge**
**Note**
Cette procédure fonctionne pour toutes AWS Batch les tâches Amazon ECS, Amazon EKS et AWS Fargate.
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans la barre de navigation, sélectionnez le Région AWS à utiliser.
1. Dans le volet de navigation, choisissez **Règles**.
1. Choisissez **Créer une règle**.
1. Dans **Nom**, spécifiez un nom unique pour votre environnement informatique. Le nom peut contenir jusqu'à 64 caractères. Il peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (\$1).
**Note**
Une règle ne peut pas avoir le même nom qu’une autre règle de la même région et sur le même bus d’événement.
1. (Facultatif) **Dans Description**, entrez une description pour la règle.
1. Pour **Event bus** (Bus d'événement), sélectionnez le bus d'événement que vous souhaitez associer à cette règle. Si vous souhaitez que cette règle mette en correspondance les événements en provenance de votre compte, sélectionnez **Par défaut**. Lorsqu'un événement Service AWS de votre compte est émis, il est toujours redirigé vers le bus d'événements par défaut de votre compte.
1. (Facultatif) Désactivez la règle sur le bus sélectionné si vous ne souhaitez pas l'exécuter immédiatement.
1. Pour **Rule type** (Type de règle), choisissez **Schedule** (Planifier).
1. Choisissez **Continuer pour créer une règle** ou **Suivant**.
1. Pour **Schedule pattern** (Planifier le modèle), effectuez l'une des étapes suivantes :
+ Choisissez **Un calendrier détaillé qui s’exécute à une heure précise, à 8 h 00 PST le premier lundi de chaque mois**, puis entrez une expression cron. Pour plus d'informations, consultez la section [Cron Expressions](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Choisissez **Un horaire qui fonctionne à un rythme régulier, par exemple toutes les 10 minutes.** puis entrez une expression de taux.
1. Choisissez **Suivant**.
1. Pour **Target types** (Types de cibles), choisissez **Service AWS**.
1. Pour **Sélectionner une cible**, choisissez **Batch job queue**. Configurez ensuite les éléments suivants :
+ **Job queue** (File d'attente de tâches) : saisissez l'Amazon Resource Name (ARN) de la file d'attente de tâches où programmer votre tâche.
+ **Job definition (Définition de tâche) :** saisissez le nom et la révision ou l'ARN complet de la définition de tâche à utiliser pour la tâche.
+ **Job name (Nom de la tâche ):** saisissez un nom pour votre tâche.
+ **Array size (Taille du tableau) :** (facultatif) saisissez une taille de tableau pour que votre tâche exécute plusieurs copies. Pour de plus amples informations, veuillez consulter [Tâches liées à](array_jobs.md).
+ **Job attempts (Tentatives d'exécution de tâche) :** (facultatif) saisissez le nombre de nouvelles tentatives pour votre tâche en cas d'échec. Pour de plus amples informations, veuillez consulter [Nouvelles tentatives de travail automatisées](job_retries.md).
1. Pour les types de cibles de **file d'attente de tâches EventBridge Batch**, une autorisation est requise pour envoyer des événements à la cible. EventBridge peut créer le rôle IAM nécessaire à l'exécution de votre règle. Effectuez l’une des actions suivantes :
+ Pour créer un rôle IAM automatiquement, sélectionnez **Create a new role for this specific resource**.
+ Pour utiliser un rôle IAM que vous avez déjà créé, choisissez **Utiliser un rôle existant**.
1. (Facultatif) Développez **Additional settings (Paramètres supplémentaires)**.
1. Pour **Configurer la saisie cible**, choisissez la manière dont le texte d'un événement est traité avant qu'il ne soit transmis à la cible.
1. Pour **Âge maximal de l'événement**, spécifiez l'intervalle de temps pendant lequel les événements non traités sont conservés.
1. Pour **Réessayer, entrez le nombre de tentatives** renouvelées pour un événement.
1. Pour la **file d'attente de lettres mortes,** choisissez une option concernant la manière dont les événements non traités sont gérés. Si nécessaire, spécifiez la file d'attente Amazon SQS à utiliser comme file d'attente de lettres mortes.
1. (Facultatif) Sélectionnez **Add another target** (Ajouter une autre cible) pour ajouter une nouvelle cible pour cette règle.
1. Choisissez **Suivant**.
1. (Facultatif) Pour les **balises**, choisissez **Ajouter une nouvelle balise** pour ajouter une étiquette de ressource pour la règle. Pour plus d'informations, consultez [Amazon EventBridge tags](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html).
1. Choisissez **Suivant**.
1. Pour **Réviser et créer**, passez en revue les étapes de configuration. Si vous devez apporter des modifications, choisissez **Modifier**. Lorsque vous avez terminé, choisissez **Créer une règle**.
Pour plus d'informations sur la création de règles, consultez [la section Création d'une EventBridge règle Amazon exécutée selon un calendrier](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
# Tutoriel : Création d'une règle avec un modèle d'événement
La procédure suivante explique comment créer une règle avec un modèle d'événement.
**Pour créer une règle qui envoie l'événement à une cible lorsque l'événement correspond à un modèle défini**
**Note**
Cette procédure fonctionne pour toutes AWS Batch les tâches Amazon ECS, Amazon EKS et AWS Fargate.
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans la barre de navigation, sélectionnez le Région AWS à utiliser.
1. Dans le volet de navigation, choisissez **Règles**.
1. Choisissez **Créer une règle**.
1. Dans **Nom**, spécifiez un nom unique pour votre environnement informatique. Le nom peut contenir jusqu'à 64 caractères. Il peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (\$1).
**Note**
Une règle ne peut pas avoir le même nom qu’une autre règle de la même région et sur le même bus d’événement.
1. (Facultatif) **Dans Description**, entrez une description pour la règle.
1. Pour **Event bus** (Bus d'événement), sélectionnez le bus d'événement que vous souhaitez associer à cette règle. Si vous souhaitez que cette règle mette en correspondance les événements en provenance de votre compte, sélectionnez **Par défaut**. Lorsqu'un événement Service AWS de votre compte est émis, il est toujours redirigé vers le bus d'événements par défaut de votre compte.
1. (Facultatif) Désactivez la règle sur le bus sélectionné si vous ne souhaitez pas l'exécuter immédiatement.
1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.
1. Choisissez **Suivant**.
1. Pour **Event Source**, choisissez un **AWS événement ou des événements EventBridge partenaires**.
1. (Facultatif) Pour **un exemple d'événement** :
1. Dans **Exemple de type d'événement**, sélectionnez **AWS événements**.
1. Pour **Sample events**, choisissez **Batch Job State Change**.
1. Pour **Méthode de création**, choisissez **Utiliser le formulaire d’événement**.
1. Pour le **modèle d'événement** :
1. Pour **Event source (Source d’événement)**, choisissez **Services AWS**.
1. Pour **Service AWS**, choisissez **Batch**.
1. Pour **Type d'événement**, choisissez **Batch Job State Change**.
1. Choisissez **Suivant**.
1. Pour **Target types** (Types de cibles), choisissez **Service AWS**.
1. Pour **Sélectionner une cible**, choisissez un type de cible. Par exemple, choisissez **Batch job queue**. Spécifiez ensuite les éléments suivants :
+ **Job queue** (File d'attente de tâches) : saisissez l'Amazon Resource Name (ARN) de la file d'attente de tâches où programmer votre tâche.
+ **Job definition (Définition de tâche) :** saisissez le nom et la révision ou l'ARN complet de la définition de tâche à utiliser pour la tâche.
+ **Job name (Nom de la tâche ):** saisissez un nom pour votre tâche.
+ **Array size (Taille du tableau) :** (facultatif) saisissez une taille de tableau pour que votre tâche exécute plusieurs copies. Pour de plus amples informations, veuillez consulter [Tâches liées à](array_jobs.md).
+ **Job attempts (Tentatives d'exécution de tâche) :** (facultatif) saisissez le nombre de nouvelles tentatives pour votre tâche en cas d'échec. Pour de plus amples informations, veuillez consulter [Nouvelles tentatives de travail automatisées](job_retries.md).
1. Pour les types de cibles de **file d'attente de tâches EventBridge Batch**, une autorisation est requise pour envoyer des événements à la cible. EventBridge peut créer le rôle IAM nécessaire à l'exécution de votre règle. Effectuez l’une des actions suivantes :
+ Pour créer un rôle IAM automatiquement, choisissez **Create a new role for this specific resource**.
+ Pour utiliser un rôle IAM que vous avez créé auparavant, choisissez **Utiliser le rôle existant**.
1. (Facultatif) Développez **Additional settings (Paramètres supplémentaires)**.
1. Pour **Configurer la saisie cible**, choisissez le mode de traitement du texte d'un événement.
1. Pour **Âge maximal de l'événement**, spécifiez l'intervalle de temps pendant lequel les événements non traités sont conservés.
1. Pour **Réessayer, entrez le nombre de tentatives** renouvelées pour un événement.
1. Pour la **file d'attente de lettres mortes,** choisissez une option concernant la manière dont les événements non traités sont gérés. Si nécessaire, spécifiez la file d'attente Amazon SQS à utiliser comme file d'attente de lettres mortes.
1. (Facultatif) Choisissez **Ajouter une autre cible** pour ajouter une cible supplémentaire.
1. Choisissez **Suivant**.
1. (Facultatif) Pour les **balises**, choisissez **Ajouter une nouvelle balise** pour ajouter une étiquette de ressource. Pour plus d'informations, consultez les [ EventBridge balises Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) dans le *guide de EventBridge l'utilisateur Amazon*.
1. Choisissez **Suivant**.
1. Pour **Réviser et créer**, passez en revue les étapes de configuration. Si vous devez apporter des modifications, choisissez **Modifier**. Lorsque vous avez terminé, choisissez **Créer une règle**.
Pour plus d'informations sur la création de règles, consultez [la section Création de EventBridge règles Amazon qui réagissent aux événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
# Tutoriel : Transmettre les informations d'un événement à une AWS Batch cible selon un calendrier à l'aide du transformateur EventBridge d'entrée
Vous pouvez utiliser le transformateur EventBridge d'entrée pour transmettre des informations sur les événements AWS Batch lors de la soumission d'une tâche. Cela peut être particulièrement utile si vous invoquez des tâches à la suite d'autres informations relatives à un AWS événement. Le téléchargement d'un objet dans un compartiment Amazon S3 en est un exemple. Vous pouvez également utiliser une définition de tâche avec des valeurs de substitution de paramètres dans la commande du conteneur. Le transformateur EventBridge d'entrée peut fournir les valeurs des paramètres en fonction des données d'événement.
Ensuite, vous créez une cible d' AWS Batch événement qui analyse les informations de l'événement qui le lance et les transforme en `parameters` objet. Lorsque la tâche s'exécute, les paramètres de l'événement déclencheur sont transmis à la commande du conteneur de tâches.
**Note**
Dans ce scénario, toutes les AWS ressources (telles que les compartiments, les EventBridge règles et les CloudTrail journaux Amazon S3) doivent se trouver dans la même région.
**Pour créer une AWS Batch cible utilisant le transformateur d'entrée**
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans la barre de navigation, sélectionnez le Région AWS à utiliser.
1. Dans le panneau de navigation, choisissez **Rules**.
1. Choisissez **Créer une règle**.
1. Dans **Nom**, spécifiez un nom unique pour votre environnement informatique. Le nom peut contenir jusqu'à 64 caractères. Il peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (\$1).
**Note**
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.
1. (Facultatif) Dans le champ **Description**, saisissez une description pour la règle.
1. Pour **Event bus** (Bus d'événement), sélectionnez le bus d'événement que vous souhaitez associer à cette règle. Si vous souhaitez que cette règle mette en correspondance les événements en provenance de votre compte, sélectionnez **Par défaut**. Lorsqu'un événement Service AWS de votre compte est émis, il est toujours redirigé vers le bus d'événements par défaut de votre compte.
1. (Facultatif) Désactivez la règle sur le bus sélectionné si vous ne souhaitez pas l'exécuter immédiatement.
1. Pour **Rule type** (Type de règle), choisissez **Schedule** (Planifier).
1. Choisissez **Continuer pour créer une règle** ou **Suivant**.
1. Pour **Schedule pattern** (Planifier le modèle), effectuez l'une des étapes suivantes :
+ Choisissez **Un calendrier détaillé qui s’exécute à une heure précise, à 8 h 00 PST le premier lundi de chaque mois**, puis entrez une expression cron. Pour plus d'informations, consultez la section [Cron Expressions](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) dans le *guide de EventBridge l'utilisateur Amazon*.
+ Choisissez **Un horaire qui fonctionne à un rythme régulier, par exemple toutes les 10 minutes.** puis entrez une expression de taux.
1. Choisissez **Suivant**.
1. Pour **Target types** (Types de cibles), choisissez **Service AWS**.
1. Pour **Sélectionner une cible**, choisissez **Batch job queue**. Configurez ensuite les éléments suivants :
+ **Job queue** (File d'attente de tâches) : saisissez l'Amazon Resource Name (ARN) de la file d'attente de tâches où programmer votre tâche.
+ **Job definition (Définition de tâche) :** saisissez le nom et la révision ou l'ARN complet de la définition de tâche à utiliser pour la tâche.
+ **Job name (Nom de la tâche ):** saisissez un nom pour votre tâche.
+ **Array size (Taille du tableau) :** (facultatif) saisissez une taille de tableau pour que votre tâche exécute plusieurs copies. Pour de plus amples informations, veuillez consulter [Tâches liées à](array_jobs.md).
+ **Job attempts (Tentatives d'exécution de tâche) :** (facultatif) saisissez le nombre de nouvelles tentatives pour votre tâche en cas d'échec. Pour de plus amples informations, veuillez consulter [Nouvelles tentatives de travail automatisées](job_retries.md).
1. Pour les types de cibles de **file d'attente de tâches EventBridge Batch**, une autorisation est requise pour envoyer des événements à la cible. EventBridge peut créer le rôle IAM nécessaire à l'exécution de votre règle. Effectuez l’une des actions suivantes :
+ Pour créer un rôle IAM automatiquement, sélectionnez **Create a new role for this specific resource**.
+ Pour utiliser un rôle IAM que vous avez déjà créé, choisissez **Utiliser un rôle existant**.
1. (Facultatif) Développez **Additional settings (Paramètres supplémentaires)**.
1. Dans la section **Additional settings** (Réglages supplémentaires), pour **Configure target input** (Configurer l'entrée cible), choisissez **Input Transformer** (Transformateur d'entrée).
1. Choisissez **Configure input transformer** (Configurer le transformateur d'entrée).
1. (Facultatif) Pour **un exemple d'événement** :
1. Dans **Exemple de type d'événement**, sélectionnez **AWS événements**.
1. Pour **Sample events**, choisissez **Batch Job State Change**.
1. Dans la section **Target input transformer** (Transformateur d'entrée cible), pour **Input path** (Chemin d'entrée), spécifiez les valeurs à analyser depuis l'événement déclencheur. Par exemple, pour analyser l'événement **Batch Job State Change**, utilisez le format JSON suivant.
```
{
"instance": "$.detail.jobId",
"state": "$.detail.status"
}
```
1. Pour **Modèle**, entrez ce qui suit.
```
{
"instance": ,
"status":
}
```
1. Choisissez **Confirmer**.
1. Pour **Âge maximal de l'événement**, spécifiez l'intervalle de temps pendant lequel les événements non traités sont conservés.
1. Pour **Réessayer, entrez le nombre de tentatives** renouvelées pour un événement.
1. Pour la **file d'attente de lettres mortes,** choisissez une option concernant la manière dont les événements non traités sont gérés. Si nécessaire, spécifiez la file d'attente Amazon SQS à utiliser comme file d'attente de lettres mortes.
1. (Facultatif) Choisissez **Ajouter une autre cible** pour ajouter une cible supplémentaire.
1. Choisissez **Suivant**.
1. (Facultatif) Pour les **balises**, choisissez **Ajouter une nouvelle balise** pour ajouter une étiquette de ressource. Pour plus d'informations, consultez les [ EventBridge balises Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) dans le *guide de EventBridge l'utilisateur Amazon*.
1. Choisissez **Suivant**.
1. Pour **Réviser et créer**, passez en revue les étapes de configuration. Si vous devez apporter des modifications, choisissez **Modifier**. Lorsque vous avez terminé, choisissez **Créer une règle**.