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 flux d'événements pour Amazon EventBridge
Vous pouvez utiliser le flux d' AWS Batch événements pour qu'Amazon EventBridge reçoive des notifications en temps quasi réel concernant l'état actuel des offres d'emploi dans vos files d'attente.
Vous pouvez l'utiliser EventBridge pour obtenir de plus amples informations sur votre AWS Batch service. Plus précisément, vous pouvez l'utiliser pour vérifier l'avancement des tâches, créer des flux de travail AWS Batch personnalisés, générer des rapports ou des statistiques d'utilisation, ou créer vos propres tableaux de bord. Avec AWS Batch et EventBridge, vous n'avez pas besoin d'un code de planification et de surveillance qui interroge en permanence AWS Batch les changements de statut des tâches. Au lieu de cela, vous pouvez gérer les modifications de l'état des AWS Batch tâches de manière asynchrone à l'aide de diverses cibles Amazon EventBridge . Il s'agit AWS Lambda notamment d'Amazon Simple Queue Service, d'Amazon Simple Notification Service ou d'Amazon Kinesis Data Streams.
Les événements du flux d' AWS Batch événements sont assurés d'être diffusés au moins une fois. Dans le cas où des événements dupliqués sont envoyés, l'événement fournit suffisamment d'informations pour identifier les doublons. Ainsi, vous pouvez comparer l'horodatage de l'événement et le statut de la tâche.
AWS Batch des emplois sont disponibles en tant que EventBridge cibles. À l'aide de règles simples, vous pouvez faire correspondre les événements et soumettre AWS Batch des offres d'emploi en réponse à ceux-ci. 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 se déclenchent automatiquement à 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 afficher un exemple de procédure, consultez [AWS Batch les emplois en tant que EventBridge cibles](batch-cwe-target.md). Pour plus d'informations sur l'utilisation du EventBridge planificateur, consultez la section [Configuration d'Amazon EventBridge Scheduler dans](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html) le guide de l'utilisateur Amazon. EventBridge
**Topics**
+ [AWS Batch événements](batch_cwe_events.md)
+ [Tutoriel : Utiliser les notifications AWS utilisateur avec AWS Batch](using-user-notifications.md)
+ [AWS Batch les emplois en tant que EventBridge cibles](batch-cwe-target.md)
+ [Tutoriel : écoutez les événements liés à l' AWS Batch emploi en utilisant EventBridge](batch_cwet.md)
+ [Tutoriel : envoi d'alertes Amazon Simple Notification Service en cas d'échec d'une tâche](batch_sns_tutorial.md)
# AWS Batch événements
AWS Batch envoie les événements de modification du statut de la tâche à EventBridge. AWS Batch suit l'état de vos emplois. Si le statut d'une tâche précédemment soumise change, un événement est invoqué. Par exemple, si une tâche ayant le `RUNNING` statut passe au `FAILED` statut. Ces événements sont considérés comme des événements de changement d'état de tâche.
**Note**
AWS Batch pourrait ajouter d'autres types d'événements, sources et détails à l'avenir. Si vous désérialisez par programmation les données JSON des événements, assurez-vous que votre application est prête à gérer des propriétés inconnues. Cela permet d'éviter des problèmes si et quand ces propriétés supplémentaires sont ajoutées.
# Événements liés à la modification de l'état du poste
Chaque fois qu'une tâche existante (précédemment soumise) change d'état, un événement est créé. Pour plus d'informations sur les états des AWS Batch tâches, consultez[États de l'emploi](job_states.md).
**Note**
Les événements ne sont pas créés pour la soumission initiale de la tâche.
**Example Événement de modification de l'état de tâche**
Les événements de modification de l'état du job sont fournis dans le format suivant. La `detail` section ressemble à l'[JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)objet renvoyé par une opération d'[DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API dans la *référence AWS Batch d'API*. Pour plus d'informations sur EventBridge les paramètres, consultez la section [Événements et modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le *guide de EventBridge l'utilisateur Amazon*.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Job State Change",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
],
"detail": {
"jobArn": "arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobName": "event-test",
"jobId": "4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/PexjEHappyPathCanary2JobQueue",
"status": "RUNNABLE",
"attempts": [],
"createdAt": 1641944200058,
"retryStrategy": {
"attempts": 2,
"evaluateOnExit": []
},
"dependsOn": [],
"jobDefinition": "arn:aws:batch:us-east-1:123456789012:job-definition/first-run-job-definition:1",
"parameters": {},
"container": {
"image": "137112412989.dkr.ecr.us-east-1.amazonaws.com/amazonlinux:latest",
"command": [
"sleep",
"600"
],
"volumes": [],
"environment": [],
"mountPoints": [],
"ulimits": [],
"networkInterfaces": [],
"resourceRequirements": [
{
"value": "2",
"type": "VCPU"
}, {
"value": "256",
"type": "MEMORY"
}
],
"secrets": []
},
"propagateTags": false,
"platformCapabilities": []
}
}
```
# Événements bloqués dans la file d'offres d'emploi
Chaque fois qu'une tâche est AWS Batch détectée dans `RUNNABLE` cet état et bloque ainsi une file d'attente, un événement est créé dans Amazon CloudWatch Events. Pour plus d'informations sur les causes de blocage des files d'attente prises en charge, consultez[Offres d'emploi bloquées dans un `RUNNABLE` statut](job_stuck_in_runnable.md). La même raison est également disponible dans le `statusReason` champ de l'action [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API.
**Example Événement bloqué dans la file d'offres d'emploi**
Les événements bloqués dans la file d'attente de tâches sont transmis au format suivant. La `detail` section ressemble à l'[JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)objet renvoyé par une opération d'[DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API dans la *référence AWS Batch d'API*. Pour plus d'informations sur EventBridge les paramètres, consultez la section [Événements et modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le *guide de EventBridge l'utilisateur Amazon*.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Job Queue Blocked",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"arn:aws:batch:us-east-1:123456789012:job-queue/PexjEHappyPathCanary2JobQueue"
],
"detail": {
"jobArn": "arn:aws:batch:us-east-1:123456789012:job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobName": "event-test",
"jobId": "4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/PexjEHappyPathCanary2JobQueue",
"status": "RUNNABLE",
"statusReason": "blocked-reason",
"attempts": [],
"createdAt": 1641944200058,
"retryStrategy": {
"attempts": 2,
"evaluateOnExit": []
},
"dependsOn": [],
"jobDefinition": "arn:aws:batch:us-east-1:123456789012:job-definition/first-run-job-definition:1",
"parameters": {},
"container": {
"image": "137112412989.dkr.ecr.us-east-1.amazonaws.com/amazonlinux:latest",
"command": [
"sleep",
"600"
],
"volumes": [],
"environment": [],
"mountPoints": [],
"ulimits": [],
"networkInterfaces": [],
"resourceRequirements": [
{
"value": "2",
"type": "VCPU"
}, {
"value": "256",
"type": "MEMORY"
}
],
"secrets": []
},
"propagateTags": false,
"platformCapabilities": []
}
}
```
# Événements de modification de l'état des tâches de service
Chaque fois qu'une tâche de service existante change d'état, un événement est créé. Pour plus d'informations sur les états des tâches de service, consultez[Mappage AWS Batch de l'état de la tâche du service avec SageMaker le statut de](service-job-status.md).
**Note**
Les événements ne sont pas créés pour la soumission initiale de la tâche.
**Example Événement de changement d'état de Service Job**
Les événements de modification de l'état des tâches de service sont fournis dans le format suivant. La `detail` section ressemble à la réponse renvoyée par une opération d'[DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API dans la *référence AWS Batch d'API*. Pour plus d'informations sur EventBridge les paramètres, consultez la section [Événements et modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Les `serviceRequestPayload` champs `tags` et ne sont pas inclus dans l'événement`detail`.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Service Job State Change",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
],
"detail": {
"attempts": [
{
"serviceResourceId": {
"name": "TrainingJobArn",
"value": "arn:aws:sagemaker:us-east-1:123456789012:training-job/AWSBatchmy-training-job88b610a69aa8380ca5b0a7aba3f81cb8"
},
"startedAt": 1641944300058,
"stoppedAt": 1641944400058,
"statusReason": "Received status from SageMaker: Training job completed"
}
],
"createdAt": 1641944200058,
"jobArn": "arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobId": "0bb17543-ece6-4480-b1a7-a556d344746b",
"jobName": "event-test",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/HappyPathJobQueue",
"latestAttempt": {
"serviceResourceId": {
"name": "TrainingJobArn",
"value": "arn:aws:sagemaker:us-east-1:123456789012:training-job/AWSBatchmy-training-job88b610a69aa8380ca5b0a7aba3f81cb8"
}
},
"serviceJobType": "SAGEMAKER_TRAINING",
"startedAt": 1641944300058,
"status": "SUCCEEDED",
"statusReason": "Received status from SageMaker: Training job completed",
"stoppedAt": 1641944400058,
"timeoutConfig": {
"attemptDurationSeconds": 60
}
}
}
```
# Événements bloqués dans la file d'attente des tâches de service
Chaque fois qu'une file d'attente bloquée est AWS Batch détectée, un événement est créé dans Amazon CloudWatch Events. La raison du blocage de la file d'attente est disponible dans le `statusReason` champ de l'action [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API.
**Example Événement bloqué par Service Job Queue**
Les événements bloqués dans la file d'attente des tâches de service sont transmis au format suivant. La `detail` section ressemble à la réponse renvoyée par l'opération d'[DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API dans la *référence AWS Batch d'API*. Pour plus d'informations sur EventBridge les paramètres, consultez la section [Événements et modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Les `serviceRequestPayload` champs `tags` et ne sont pas inclus dans l'événement`detail`.
```
{
"version": "0",
"id": "c8f9c4b5-76e5-d76a-f980-7011e206042b",
"detail-type": "Batch Service Job Queue Blocked",
"source": "aws.batch",
"account": "123456789012",
"time": "2022-01-11T23:36:40Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8"
],
"detail": {
"attempts": [],
"createdAt": 1641944200058,
"jobArn": "arn:aws:batch:us-east-1:123456789012:service-job/4c7599ae-0a82-49aa-ba5a-4727fcce14a8",
"jobId": "6271dfdf-d8a7-41b1-a4d2-55a2224f5375",
"jobName": "event-test",
"jobQueue": "arn:aws:batch:us-east-1:123456789012:job-queue/HappyPathJobQueue",
"serviceJobType": "SAGEMAKER_TRAINING",
"status": "RUNNABLE",
"statusReason": "blocked-reason",
"timeoutConfig": {
"attemptDurationSeconds": 60
}
}
}
```
# Événements de préemption d'un emploi dans le secteur des services
Les événements de préemption sont publiés chaque fois qu'une séquence de préemption commence ou se termine. Un événement démarré est créé lorsque la préemption est déclenchée pour la première fois pour récupérer la capacité empruntée. Un événement terminé est créé lorsque la séquence de préemption se termine et inclut un résumé des tentatives préemptées.
**Example Événement lancé par Service Job Preemption**
Les événements déclenchés par la préemption d'une tâche de service sont présentés dans le format suivant. Pour plus d'informations sur EventBridge les paramètres, consultez la section [Événements et modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le *guide de EventBridge l'utilisateur Amazon*.
```
{
"version": "0",
"id": "1b4a511e-2737-226a-a1e7-fc97f1cd9681",
"detail-type": "Batch Service Job Preemption Started",
"source": "aws.batch",
"account": "123456789012",
"time": "2026-03-16T19:57:27Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84"
],
"detail": {
"statusReason": "PREEMPTION_IN_PROGRESS: Cross-share preemption triggered to reclaim borrowed capacity",
"preemptedJobArn": "arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84",
"status": "RUNNING"
}
}
```
**Example Événement terminé avec Service Job Preemption**
Les événements terminés relatifs à la préemption des tâches de service sont présentés dans le format suivant. Le `preemptionSummary` champ contient des détails sur les tentatives préemptées, notamment le nombre de tentatives préemptées et les informations les plus récentes.
```
{
"version": "0",
"id": "2b1c6151-c166-edf5-822c-211b3bfd46b2",
"detail-type": "Batch Service Job Preemption Completed",
"source": "aws.batch",
"account": "123456789012",
"time": "2026-03-16T19:57:47Z",
"region": "us-east-1",
"resources": [
"arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84"
],
"detail": {
"preemptedJobArn": "arn:aws:batch:us-east-1:123456789012:service-job/51f245a9-2995-4a53-bced-7b3c00028f84",
"preemptionSummary": {
"preemptedAttemptCount": 1,
"recentPreemptedAttempts": [
{
"serviceResourceId": {
"name": "TrainingJobArn",
"value": "arn:aws:sagemaker:us-east-1:123456789012:training-job/AWSBatchqm-training-job9b2f08f911cf3dd794c1b3e72ae7ca5f"
},
"startedAt": 1773690923359,
"stoppedAt": 1773691064669,
"statusReason": "Cross-share preemption triggered to reclaim borrowed capacity"
}
]
},
"status": "RUNNABLE"
}
}
```
# Tutoriel : Utiliser les notifications AWS utilisateur avec AWS Batch
Vous pouvez utiliser [les notifications AWS utilisateur](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) pour configurer des canaux de diffusion afin d'être informé AWS Batch des événements. Vous recevez une notification lorsqu'un événement correspond à une règle que vous avez spécifiée. Vous pouvez recevoir des notifications relatives à des événements via plusieurs canaux, notamment par email, via des notifications de chat [Amazon Q Developer dans les applications de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) ou via des notifications push de l’[AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html). Vous pouvez également consulter les notifications dans le [Centre de notifications de la console](https://console.aws.amazon.com/notifications/). Notifications utilisateur prend en charge l'agrégation, ce qui peut réduire le nombre de notifications que vous recevez lors d'événements spécifiques.
Pour configurer les notifications utilisateur dans AWS Batch :
1. Ouvrez la [AWS Batch console](https://console.aws.amazon.com/batch/home).
1. Choisissez **Tableau de bord**.
1. Choisissez **Configurer les notifications**.
1. Dans **Notifications AWS utilisateur**, choisissez **Créer une configuration de notification**.
Pour plus d'informations sur la façon de configurer et d'afficher les notifications utilisateur, voir [Commencer à utiliser les notifications AWS utilisateur](https://docs.aws.amazon.com/notifications/latest/userguide/getting-started.html).
# 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**.
# Tutoriel : écoutez les événements liés à l' AWS Batch emploi en utilisant EventBridge
Dans ce didacticiel, vous allez configurer une AWS Lambda fonction simple qui écoute les événements liés aux AWS Batch tâches et les enregistre dans un flux de log CloudWatch Logs.
## Prérequis
Ce didacticiel suppose que vous disposez d'un environnement de calcul en fonctionnement et une file d'attente prête à accepter des tâches. Si vous ne disposez pas d'un environnement informatique en cours d'exécution ni d'une file d'attente de tâches à partir desquels capturer les événements, suivez les étapes [Commencer à utiliser les AWS Batch didacticiels](Batch_GetStarted.md) décrites pour en créer une. À la fin de ce didacticiel, vous pouvez éventuellement soumettre une tâche à cette file d'attente de tâches pour vérifier que vous avez correctement configuré votre fonction Lambda.
**Topics**
+ [Prérequis](#cwet_prereqs)
+ [Tutoriel : Création de la fonction Lambda](cwet_create_lam.md)
+ [Tutoriel : Enregistrer la règle de l'événement](cwet_register_event_rule.md)
+ [Tutoriel : Testez votre configuration](cwet_test.md)
# Tutoriel : Création de la fonction Lambda
Dans cette procédure, vous créez une fonction Lambda simple qui servira de cible aux messages du flux d' AWS Batch événements.
**Pour créer une fonction Lambda cible**
1. Ouvrez la AWS Lambda console à l'adresse [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).
1. Sélectionnez **Create function** (Créer une fonction), puis **Author from scratch** (Créer à partir de zéro).
1. Sous **Nom de la fonction**, saisissez **batch-event-stream-handler**.
1. Pour **Environnement d’exécution**, sélectionnez **Python 3.8**.
1. Sélectionnez **Create function** (Créer une fonction).
1. Dans la section **Source du code**, modifiez l'exemple de code pour qu'il corresponde à l'exemple suivant :
```
import json
def lambda_handler(event, _context):
# _context is not used
del _context
if event["source"] != "aws.batch":
raise ValueError("Function only supports input from events with a source type of: aws.batch")
print(json.dumps(event))
```
Il s'agit d'une simple fonction Python 3.8 qui affiche les événements envoyés par AWS Batch. Si tout est correctement configuré, à la fin de ce didacticiel, les détails de l'événement apparaissent dans le flux du journal CloudWatch des journaux associé à cette fonction Lambda.
1. Choisissez **Déployer**.
# Tutoriel : Enregistrer la règle de l'événement
Dans cette section, vous allez créer une règle d' EventBridge événement qui capture les événements liés aux tâches qui proviennent de vos AWS Batch ressources. Cette règle capture tous les événements AWS Batch provenant du compte où elle est définie. Les messages de travail eux-mêmes contiennent des informations sur la source de l'événement, y compris la file d'attente des tâches dans laquelle il a été soumis. Vous pouvez utiliser ces informations pour filtrer et trier les événements par programmation.
**Note**
Si vous utilisez la règle AWS Management Console pour créer un événement, la console ajoute automatiquement les autorisations IAM EventBridge pour appeler votre fonction Lambda. Toutefois, si vous créez une règle d'événement à l'aide du AWS CLI, vous devez accorder des autorisations de manière explicite. Pour plus d'informations, consultez la section [Événements et modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le *guide de EventBridge l'utilisateur Amazon*.
**Pour créer votre EventBridge règle**
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans le volet de navigation, choisissez **Règles**.
1. Choisissez **Créer une règle**.
1. Saisissez un nom et 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 et sur le même bus d'événement.
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 corresponde aux événements provenant de votre compte, sélectionnez **Bus d’événements par défaut AWS **. Lorsqu'un AWS service de votre compte émet un événement, celui-ci est toujours redirigé vers le bus d'événements par défaut de votre compte.
1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.
1. Choisissez **Suivant**.
1. Pour **Event source** (Source de l'événement), choisissez **Other** (Autres).
1. Pour **Modèle d'événement**, sélectionnez **Modèles personnalisés (éditeur JSON)**.
1. Collez le modèle d'événement suivants dans la zone de texte.
```
{
"source": [
"aws.batch"
]
}
```
Cette règle s'applique à tous vos AWS Batch groupes et à tous les AWS Batch événements. Autrement, vous pouvez créer une règle plus spécifique pour filtrer certains résultats.
1. Choisissez **Suivant**.
1. Pour **Types de cibles**, choisissez **service AWS **.
1. Pour **Sélectionner une cible**, choisissez la fonction **Lambda, puis sélectionnez votre fonction** Lambda.
1. (Facultatif) Pour **Additional settings** (Paramètres supplémentaires), procédez comme suit :
1. Pour **Maximum age of event** (Âge maximal de l'événement), saisissez une valeur comprise entre une minute (00:01) et 24 heures (24:00).
1. Pour **Retry attempts (Nouvelles tentatives)**, saisissez un nombre compris entre 0 et 185.
1. Pour la **file d'attente de lettres mortes**, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS 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 file d'attente Amazon SQS dans le AWS compte courant à utiliser comme file d'attente de lettres mortes, puis sélectionnez la file d'attente** à utiliser dans le menu déroulant.
+ Choisissez **Sélectionnez une file d'attente Amazon SQS dans un autre AWS compte en tant que file d'attente de lettres mortes, puis entrez l'ARN de la file** 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 la section [Octroi d'autorisations à la file d'attente de lettres mortes](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) dans le guide de * EventBridge l'utilisateur Amazon*.
1. Choisissez **Suivant**.
1. (Facultatif) Saisissez une ou plusieurs balises pour la règle. 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. Consultez les détails de la règle et choisissez **Create rule** (Créer une règle).
# Tutoriel : Testez votre configuration
Vous pouvez désormais tester votre EventBridge configuration en soumettant une tâche à votre file d'attente de tâches. Si tout est correctement configuré, votre fonction Lambda est déclenchée et elle écrit les données de l'événement dans un flux de log CloudWatch Logs pour la fonction.
**Pour tester votre configuration**
1. Ouvrez la AWS Batch console à l'adresse [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Soumettez une nouvelle AWS Batch offre d'emploi. Pour de plus amples informations, veuillez consulter [Tutoriel : soumettre une offre d'emploi](submit_job.md).
1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dans le volet de navigation, choisissez **Logs et sélectionnez le groupe de journaux** pour votre fonction Lambda (par exemple, ***my-function*/aws/lambda/**).
1. Sélectionnez un flux de journaux pour afficher les données d'événement.
# Tutoriel : envoi d'alertes Amazon Simple Notification Service en cas d'échec d'une tâche
Dans ce didacticiel, vous allez configurer une règle d' EventBridge événement Amazon qui capture uniquement les événements liés aux tâches lorsque le statut de la tâche est passé à un `FAILED` statut. À la fin de ce didacticiel, vous pouvez également éventuellement soumettre une tâche à cette file d'attente de tâches. Cela permet de vérifier que vous avez correctement configuré vos alertes Amazon SNS.
## Prérequis
Ce didacticiel suppose que vous disposez d'un environnement de calcul en fonctionnement et une file d'attente prête à accepter des tâches. Si vous ne disposez pas d'un environnement informatique en cours d'exécution ni d'une file d'attente de tâches à partir desquels capturer les événements, suivez les étapes [Commencer à utiliser les AWS Batch didacticiels](Batch_GetStarted.md) décrites pour en créer une.
**Topics**
+ [Prérequis](#batch_sns_prereq)
+ [Tutoriel : créer une rubrique Amazon SNS et s'y abonner](batch_sns_create_topic.md)
+ [Tutoriel : Enregistrer une règle d'événement](batch_sns_reg_rule.md)
+ [Tutoriel : Testez votre règle](batch_sns_test_rule.md)
+ [Règle alternative : file d'attente des tâches Batch bloquée](#test_blocked_job_queue)
# Tutoriel : créer une rubrique Amazon SNS et s'y abonner
Pour ce didacticiel, vous configurez une rubrique Amazon SNS à utiliser comme une cible de l'événement pour votre nouvelle règle d'événement.
**Pour créer une rubrique Amazon SNS**
1. [Ouvrez la console Amazon SNS à l'adresse v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)
1. Choisissez **Topics** (Rubriques), **Create topic** (Créer une rubrique).
1. Pour **Type**, choisissez **Standard**.
1. Dans le **champ Nom**, entrez **JobFailedAlert** et choisissez **Créer un sujet**.
1. Sur l'**JobFailedAlert**écran, choisissez **Créer un abonnement**.
1. Pour **Protocole**, choisissez **E-mail**.
1. Dans le champ **Endpoint** (Point de terminaison), saisissez l'adresse e-mail à laquelle vous avez actuellement accès et choisissez **Create subscription** (Créer un abonnement).
1. Vérifiez votre compte de messagerie et attendez de recevoir un e-mail de confirmation de l'abonnement. Lorsque vous le recevez, choisissez **Confirm subscription** (Confirmer l'abonnement).
# Tutoriel : Enregistrer une règle d'événement
Ensuite, enregistrez une règle d'événement qui capture uniquement les événements d'échec de tâche.
**Pour enregistrer votre EventBridge règle**
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans le volet de navigation, choisissez **Règles**.
1. Choisissez **Créer une règle**.
1. Saisissez un nom et 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 et sur le même bus d'événement.
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 corresponde aux événements provenant de votre compte, sélectionnez **Bus d’événements par défaut AWS **. Lorsqu'un AWS service de votre compte émet un événement, celui-ci est toujours redirigé vers le bus d'événements par défaut de votre compte.
1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.
1. Choisissez **Suivant**.
1. Pour **Event source** (Source de l'événement), choisissez **Other** (Autres).
1. Pour **Modèle d'événement**, sélectionnez **Modèles personnalisés (éditeur JSON)**.
1. Collez le modèle d'événement suivants dans la zone de texte.
```
{
"detail-type": [
"Batch Job State Change"
],
"source": [
"aws.batch"
],
"detail": {
"status": [
"FAILED"
]
}
}
```
Ce code définit une EventBridge règle qui correspond à tout événement correspondant au statut de la tâche`FAILED`. Pour plus d'informations sur les modèles d'événements, consultez la section [Événements et modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le *guide de EventBridge l'utilisateur Amazon*.
1. Choisissez **Suivant**.
1. Pour **Types de cibles**, choisissez **service AWS **.
1. Pour **Sélectionner une cible**, choisissez le **sujet SNS**, et pour le **sujet**, choisissez **JobFailedAlert**.
1. (Facultatif) Pour **Additional settings** (Paramètres supplémentaires), procédez comme suit :
1. Pour **Maximum age of event** (Âge maximal de l'événement), saisissez une valeur comprise entre une minute (00:01) et 24 heures (24:00).
1. Pour **Retry attempts (Nouvelles tentatives)**, saisissez un nombre compris entre 0 et 185.
1. Pour la **file d'attente de lettres mortes**, choisissez si vous souhaitez utiliser une file d'attente Amazon SQS 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 file d'attente Amazon SQS dans le AWS compte courant à utiliser comme file d'attente de lettres mortes, puis sélectionnez la file d'attente** à utiliser dans le menu déroulant.
+ Choisissez **Sélectionnez une file d'attente Amazon SQS dans un autre AWS compte en tant que file d'attente de lettres mortes, puis entrez l'ARN de la file** 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 la section [Octroi d'autorisations à la file d'attente de lettres mortes](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) dans le guide de * EventBridge l'utilisateur Amazon*.
1. Choisissez **Suivant**.
1. (Facultatif) Saisissez une ou plusieurs balises pour la règle. 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. Consultez les détails de la règle et choisissez **Create rule** (Créer une règle).
# Tutoriel : Testez votre règle
Pour tester votre règle, soumettre une tâche qui s'arrête peu après avoir été lancée avec un code de sortie différent de 0. Si votre règle d'événement est correctement configurée, vous devriez recevoir un e-mail contenant le texte de l'événement dans les minutes qui suivent.
**Pour tester une règle**
1. Ouvrez la AWS Batch console à l'adresse [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Soumettez une nouvelle AWS Batch offre d'emploi. Pour de plus amples informations, veuillez consulter [Tutoriel : soumettre une offre d'emploi](submit_job.md). Pour la commande de tâche, remplacez cette commande pour quitter le conteneur avec un code de sortie de 1.
```
/bin/sh, -c, 'exit 1'
```
1. Vérifiez vos e-mails pour confirmer que vous avez reçu une alerte par e-mail concernant la notification d'échec de l'offre d'emploi.
## Règle alternative : file d'attente des tâches Batch bloquée
Pour créer une règle d'événement qui surveille les *files d'attente de tâches par lots bloquées*, répétez ces didacticiels avec les modifications suivantes :
1. **Dans [Tutoriel : créer une rubrique Amazon SNS et s'y abonner](batch_sns_create_topic.md)**, utilisez *BlockedJobQueue* comme nom de rubrique.
1. **Dans [Tutoriel : Enregistrer une règle d'événement](batch_sns_reg_rule.md)**, utilisez le modèle suivant dans l'éditeur JSON :
```
{
"detail-type": [
"Batch Job Queue Blocked"
],
"source": [
"aws.batch"
]
}
```