Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Transmisión de eventos de AWS Batch para Amazon EventBridge
Puede utilizar el flujo de eventos de AWS Batch de Amazon EventBridge para recibir notificaciones casi en tiempo real sobre el estado actual de los trabajos en sus colas de trabajo.
Puede usar EventBridge para obtener más información sobre su servicio de AWS Batch. Más específicamente, puede usarlo para comprobar el progreso de los trabajos, crear flujos de trabajo personalizados de AWS Batch, generar informes o métricas de uso o crear sus propios paneles. Con AWS Batch y EventBridge, puede eliminar el código de programación y monitorización que sondea continuamente los trabajos de AWS Batch para detectar cambios en su estado. En su lugar, puede gestionar los cambios de estado de los trabajos AWS Batch de forma asíncrona mediante una variedad de destinos de Amazon EventBridge. Entre ellos se incluyen AWS Lambda, Amazon Simple Queue Service, Amazon Simple Notification Service o Amazon Kinesis Data Streams.
Se garantiza que los eventos de la secuencia de eventos de AWS Batch se entregan al menos una vez. En caso de que se envíen eventos duplicados, el evento ofrece información suficiente para identificar duplicados. De esta forma, puede comparar la marca horaria del evento y el estado del trabajo.
Los trabajos AWS Batch están disponibles como destinos de EventBridge. Mediante reglas sencillas, puede asignar eventos y enviar trabajos de AWS Batch como respuesta a ellos. Para obtener más información, consulte [¿Qué es EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) en la *Guía del usuario de Amazon EventBridge*. También puede utilizar EventBridge para programar acciones automatizadas que se activen automáticamente en determinados momentos a través de **cron** o de expresiones de frecuencia. Para obtener más información, consulte [Creación de reglas de Amazon EventBridge que se ejecutan en un horario](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) en la *Guía del usuario de Amazon EventBridge*. Para ver un tutorial de ejemplo, consulte [Trabajos de AWS Batch como destinos de EventBridge](batch-cwe-target.md). Para obtener información sobre el uso del programador de EventBridge, consulte [Configuración del Programador de Amazon EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html) en la Guía del usuario de Amazon EventBridge.
**Topics**
+ [AWS Batch eventos](batch_cwe_events.md)
+ [Tutorial: Usa las notificaciones AWS de usuario con AWS Batch](using-user-notifications.md)
+ [Trabajos de AWS Batch como destinos de EventBridge](batch-cwe-target.md)
+ [Tutorial: escucha de los eventos de trabajo de AWS Batch con EventBridge](batch_cwet.md)
+ [Tutorial: envío de alertas de Amazon Simple Notification Service para eventos de trabajos fallidos](batch_sns_tutorial.md)
# AWS Batch eventos
AWS Batch envía los eventos de cambio de estado del trabajo a EventBridge. AWS Batch rastrea el estado de sus trabajos. Si el estado de un trabajo enviado anteriormente cambia, se invoca un evento. Por ejemplo, si un trabajo en el estado `RUNNING` pasa a al estado `FAILED`. Estos eventos se clasifican como eventos de cambio en el estado de los trabajos.
**nota**
AWS Batch podría añadir otros tipos de eventos, fuentes y detalles en el futuro. Si va a deserializar datos JSON de eventos mediante programación, asegúrese de que la aplicación esté preparada para tratar propiedades desconocidas. Esto es para evitar problemas si se agregan estas propiedades adicionales y cuando se agregan.
# Eventos de cambio de estado de los trabajos
Cada vez que un trabajo existente (enviado previamente) cambia de estado, se crea un evento. Para obtener más información acerca de los estados de los trabajos de AWS Batch, consulte [Estados de trabajo](job_states.md).
**nota**
No se crean eventos para el envío inicial de los trabajos.
**Example Evento de cambio de estado de los trabajos**
Los eventos de cambio de estado de trabajo se entregan en el siguiente formato. La sección `detail` se asemeja al objeto [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html) que se devuelve de una operación de la API [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html) en la *Referencia de la API AWS Batch*. Para obtener más información acerca de los parámetros de EventBridge, consulte [Eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del usuario de Amazon EventBridge*.
```
{
"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": []
}
}
```
# Eventos bloqueados en la cola de trabajos
Cada vez que se AWS Batch detecta un trabajo en el `RUNNABLE` estado y, por lo tanto, se bloquea una cola, se crea un evento en Amazon CloudWatch Events. Para obtener más información sobre las causas de las colas de bloqueo admitidas, consulte [Trabajos bloqueados en estado `RUNNABLE`](job_stuck_in_runnable.md). El mismo motivo también está disponible en el campo `statusReason` de la acción de API [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html).
**Example Evento bloqueado en la cola de trabajos**
Los eventos bloqueados en la cola de trabajos se entregan en el siguiente formato. La `detail` sección se parece al [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)objeto devuelto por una operación de [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API en la *Referencia de AWS Batch API*. Para obtener más información sobre EventBridge los parámetros, consulte [Eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del EventBridge usuario de 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": []
}
}
```
# Eventos de cambio de estado de los trabajos
Cada vez que un trabajo de servicio existente cambia de estado, se crea un evento. Para obtener más información sobre los estados de los trabajos de servicio, consulte [Asignar el estado del trabajo del AWS Batch servicio al estado de la SageMaker IA](service-job-status.md).
**nota**
No se crean eventos para el envío inicial de los trabajos.
**Example Evento de cambio de estado de los trabajos de servicio**
Los eventos de cambio de estado de trabajo de servicio se entregan en el siguiente formato. La sección `detail` se asemeja a la respuesta que se devuelve de una operación de la API [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html) en la *Referencia de la API de AWS Batch*. Para obtener más información acerca de los parámetros de EventBridge, consulte [Eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del usuario de Amazon EventBridge*.
Los campos `tags` y `serviceRequestPayload` no se incluyen en el evento `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
}
}
}
```
# Eventos bloqueados en el trabajo de servicio
Cada vez que se AWS Batch detecta una cola bloqueada, se crea un evento en Amazon CloudWatch Events. El motivo de la cola bloqueada está disponible en el campo `statusReason` de la acción de API [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html).
**Example Evento bloqueado del servicio de la cola de trabajos**
El servicio de eventos bloqueados en la cola de trabajos se entrega en el siguiente formato. La `detail` sección se parece a la respuesta que devuelve la operación de la [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API en la *Referencia de la AWS Batch API*. Para obtener más información sobre EventBridge los parámetros, consulte [Eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del EventBridge usuario de Amazon*.
Los campos `tags` y `serviceRequestPayload` no se incluyen en el evento `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
}
}
}
```
# Eventos de prevención de tareas de servicio
Los eventos de preferencia se publican cada vez que se inicia o finaliza una secuencia de preferencia. Un evento iniciado se crea cuando se activa por primera vez la preferencia para recuperar la capacidad prestada. Un evento completado se crea cuando finaliza la secuencia de preferencia e incluye un resumen de los intentos evitados.
**Example Evento iniciado por Service Job Preemption**
Los eventos iniciados por la prevención de tareas de servicio se entregan en el siguiente formato. Para obtener más información sobre EventBridge los parámetros, consulte [Eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del EventBridge usuario de 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 Evento Service Job Preemption completado**
Los eventos de prioridad de trabajos de servicio finalizados se entregan en el siguiente formato. El `preemptionSummary` campo contiene detalles sobre los intentos prevenidos, incluido el recuento y la información sobre los intentos prevenidos más recientes.
```
{
"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"
}
}
```
# Tutorial: Usa las notificaciones AWS de usuario con AWS Batch
Puede usar [notificaciones de usuario de AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) para configurar los canales de entrega a fin de recibir notificaciones sobre los eventos de AWS Batch . Recibirá una notificación cuando un evento coincida con una regla que especifique. Puede recibir notificaciones de eventos a través de varios canales, como correo electrónico, notificaciones por chat de [Amazon Q Developer en aplicaciones de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) o notificaciones push de [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html). También puede ver las notificaciones en el [Centro de notificaciones de la consola](https://console.aws.amazon.com/notifications/). Las notificaciones de usuario admiten la agregación, lo que puede reducir el número de notificaciones que recibe durante eventos específicos.
Para configurar las notificaciones de usuario en AWS Batch:
1. Abra la [consola de AWS Batch](https://console.aws.amazon.com/batch/home).
1. Elija **Dashsboard (Panel)**.
1. Seleccione **Configurar notificaciones**.
1. En **Notificaciones de AWS usuario**, elija **Crear configuración de notificaciones**.
Para obtener más información sobre cómo configurar y ver las notificaciones de usuario, consulte [Introducción a las notificaciones AWS de usuario](https://docs.aws.amazon.com/notifications/latest/userguide/getting-started.html).
# Trabajos de AWS Batch como destinos de EventBridge
Amazon EventBridge entrega una secuencia de eventos de sistema casi en tiempo real que describe los cambios producidos en los recursos de Amazon Web Services. Por lo general, AWS Batch en Amazon Elastic Container Service, Amazon Elastic Kubernetes Service y los trabajos de AWS Fargate están disponibles como destinos de EventBridge. Mediante reglas sencillas, puede asignar eventos y enviar trabajos de AWS Batch como respuesta a ellos. Para obtener más información, consulte [¿Qué es EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) en la *Guía del usuario de Amazon EventBridge*.
También puede utilizar EventBridge para programar acciones automatizadas que se activen automáticamente en determinados momentos a través **cron** o expresiones de frecuencia. Para obtener más información, consulte [Creación de reglas de Amazon EventBridge que se ejecutan en un horario](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) en la *Guía del usuario de Amazon EventBridge*.
Para obtener información acerca de cómo crear reglas de eventos en la consola de EventBridge, consulte [Creación de reglas de Amazon EventBridge que reaccionan a los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) en la *Guía del usuario de Amazon EventBridge*.
Los casos de uso más comunes de los trabajos de AWS Batch como objetivo de EventBridge incluyen los siguientes casos de uso:
+ Un trabajo programado se produce a intervalos de tiempo regulares. Por ejemplo, un trabajo de **cron** solo se realiza durante las horas de bajo uso, cuando las instancias puntuales de spot de Amazon EC2 son menos costosas.
+ Se ejecuta un trabajo de AWS Batch en respuesta a una operación de API registrada en CloudTrail. Por ejemplo, se envía un trabajo cada vez que se carga un objeto en un bucket de Amazon S3 específico. Cada vez que esto ocurre, el transformador de entrada de EventBridge pasa el bucket y el nombre clave del objeto a los parámetros de AWS Batch.
**nota**
En este escenario, todos los recursos AWS relacionados deben estar en la misma región. Esto incluye recursos como el bucket de Amazon S3, la regla de EventBridge y los registros de CloudTrail.
Antes de poder enviar los trabajos de AWS Batch con las reglas y los destinos de EventBridge, el servicio EventBridge requiere varios permisos para ejecutar los trabajos de AWS Batch. Cuando cree una regla en la consola de EventBridge que especifique un trabajo de AWS Batch como destino, se le ofrecerá la oportunidad de crear este rol. Para obtener más información sobre la entidad principal de servicio y los permisos de IAM necesarios para este rol, consulte [EventBridge Rol de IAM](CWE_IAM_role.md).
**Topics**
+ [Tutorial: creación de un trabajo de AWS Batch programado](scheduled-batch-job.md)
+ [Tutorial: creación de una regla con un patrón de evento](event-pattern-batch-job.md)
+ [Tutorial: Pase la información del evento a un AWS Batch objetivo según un cronograma utilizando el transformador EventBridge de entrada](cwe-input-transformer.md)
# Tutorial: creación de un trabajo de AWS Batch programado
En el siguiente procedimiento se explica cómo crear un trabajo de AWS Batch programado y el rol de IAM de EventBridge necesario.
**Creación de un trabajo de AWS Batch programado con EventBridge**
**nota**
Este procedimiento funciona para todos los trabajos de AWS Batch en Amazon ECS, Amazon EKS y AWS Fargate.
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En la barra de navegación, elija la Región de AWS a utilizar.
1. En el panel de navegación, elija **Reglas**.
1. Elija **Creación de regla**.
1. En **Nombre**, especifique un nombre único para el entorno de computación. El nombre puede contener hasta 64 caracteres. Puede contener letras mayúsculas y minúsculas, números, guiones (-) y guiones bajos (\$1).
**nota**
Una regla no puede tener el mismo nombre que otra regla de la misma región y del mismo bus de eventos.
1. (Opcional) En **Descripción**, introduzca una descripción para la regla.
1. En **Bus de eventos**, elija el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, elija **predeterminado**. Cuando un Servicio de AWS en su cuenta emite un evento, siempre va al bus de eventos predeterminado de su cuenta.
1. (Opcional) Desactive la regla en el bus seleccionado si no desea ejecutarla inmediatamente.
1. En **Tipo de regla**, elija **Programación**.
1. Seleccione **Continuar para crear la regla** o **Siguiente**.
1. En **Programar patrón**, realice una de las siguientes acciones:
+ Elija **Un horario detallado que se ejecute a una hora específica, como las 8:00 a. m. PST el primer lunes de cada mes** y después introduzca la expresión cron. Para obtener más información, consulte [Expresiones cron](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) en la *Guía del usuario de Amazon EventBridge*.
+ Elija **un horario que se ejecute a un ritmo regular, por ejemplo, cada 10 minutos.** y, a continuación, introduzca una expresión de frecuencia.
1. Elija **Siguiente**.
1. En **Tipos de destino**, elija **Servicio de AWS**.
1. En **Seleccione un objetivo**, elija **Cola de trabajos por lotes**. A continuación, configure lo siguiente:
+ **Cola de trabajos**: introduzca el nombre de recurso de Amazon (ARN) de la cola de trabajos en la que va a programar el trabajo.
+ **Definición de trabajo**: introduzca el nombre y la revisión o el ARN completo de la definición de trabajo que va a utilizar para el trabajo.
+ **Nombre de trabajo**: introduzca un nombre para el trabajo.
+ **Tamaño de la matriz**: (opcional) introduzca un tamaño de matriz para que el trabajo ejecute más de una copia. Para obtener más información, consulte [Trabajos de matrices](array_jobs.md).
+ **Intentos de trabajo**: (opcional) introduzca el número de veces que se debe reintentar el trabajo si se produce un error. Para obtener más información, consulte [Reintentos automáticos de trabajo](job_retries.md).
1. En los tipos de destino de la opción **Cola de trabajos por lotes**, EventBridge necesita permiso para enviar eventos al destino. EventBridge puede crear el rol de IAM necesario para que se ejecute la regla. Realice una de las siguientes acciones:
+ Para crear un rol de IAM automáticamente, elija **Creación de un nuevo rol para este recurso específico**.
+ Para utilizar un rol de IAM que haya creado antes, elija **Uso de rol existente**.
1. (Opcional) Amplíe **Configuración adicional**.
1. En **Configurar la entrada de destino**, elija cómo se procesa el texto de un evento antes de pasarlo al destino.
1. En **Antigüedad máxima del evento**, especifique el intervalo de tiempo durante el que se guardan los eventos sin procesar.
1. En **Intentos de reintento**, introduzca el número de veces que se volverá a intentar un evento.
1. En **Cola de mensajes fallidos,** elija una opción para gestionar los eventos no procesados. Si es necesario, especifique la cola de Amazon SQS que se utilizará como la cola de mensajes fallidos.
1. (Opcional) Elija **Agregar otro destino** para agregar otro destino para esta regla.
1. Elija **Siguiente**.
1. (Opcional) En **Etiquetas**, elija **Añadir nueva etiqueta** para añadir una etiqueta de recurso a la regla. Para obtener más información, consulte [Etiquetas de Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html).
1. Elija **Siguiente**.
1. En **Revisar y crear**, revise los pasos de configuración. Si necesita realizar cambios, elija **Editar**. Cuando haya terminado, seleccione **Creación de regla**.
Para obtener más información sobre cómo crear reglas, consulte [Creación de reglas de EventBridge que reaccionan a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) en la *Guía del usuario de Amazon EventBridge*.
# Tutorial: creación de una regla con un patrón de evento
El siguiente procedimiento explica cómo crear una regla con un patrón de evento.
**Cómo crear una regla que envíe el evento a un destino cuando el evento coincida con un patrón definido**
**nota**
Este procedimiento funciona para todos los trabajos de AWS Batch en Amazon ECS, Amazon EKS y AWS Fargate.
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En la barra de navegación, elija la Región de AWS a utilizar.
1. En el panel de navegación, elija **Reglas**.
1. Elija **Creación de regla**.
1. En **Nombre**, especifique un nombre único para el entorno de computación. El nombre puede contener hasta 64 caracteres. Puede contener letras mayúsculas y minúsculas, números, guiones (-) y guiones bajos (\$1).
**nota**
Una regla no puede tener el mismo nombre que otra regla de la misma región y del mismo bus de eventos.
1. (Opcional) En **Descripción**, introduzca una descripción para la regla.
1. En **Bus de eventos**, elija el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, elija **predeterminado**. Cuando un Servicio de AWS en su cuenta emite un evento, siempre va al bus de eventos predeterminado de su cuenta.
1. (Opcional) Desactive la regla en el bus seleccionado si no desea ejecutarla inmediatamente.
1. En **Tipo de regla**, elija **Regla con un patrón de evento**.
1. Seleccione **Siguiente**.
1. En **Origen del evento**, elija **AWS Eventos o eventos de socios de EventBridge**.
1. (Opcional) En **Ejemplo de evento**:
1. En **Ejemplo de tipo de evento**, elija **eventos de AWS**.
1. En **Eventos de muestra**, elija **Cambiar estado de trabajo por lotes**.
1. En **Método de creación,** elija **Uso de forma de patrón**.
1. En **Patrón de eventos**:
1. En **Origen del evento**, elija **Servicios de AWS**.
1. En **Servicio de AWS**, elija **Lote**.
1. En **Tipo de evento**, elija **Cambio de estado de trabajo por lotes**.
1. Seleccione **Siguiente**.
1. En **Tipos de destino**, elija **Servicio de AWS**.
1. En **Elegir un tipo de destino**, elija un tipo de destino. Por ejemplo, elija **Cola de trabajos por lotes**. A continuación, especifique lo siguiente:
+ **Cola de trabajos**: introduzca el nombre de recurso de Amazon (ARN) de la cola de trabajos en la que va a programar el trabajo.
+ **Definición de trabajo**: introduzca el nombre y la revisión o el ARN completo de la definición de trabajo que va a utilizar para el trabajo.
+ **Nombre de trabajo**: introduzca un nombre para el trabajo.
+ **Tamaño de la matriz**: (opcional) introduzca un tamaño de matriz para que el trabajo ejecute más de una copia. Para obtener más información, consulte [Trabajos de matrices](array_jobs.md).
+ **Intentos de trabajo**: (opcional) introduzca el número de veces que se debe reintentar el trabajo si se produce un error. Para obtener más información, consulte [Reintentos automáticos de trabajo](job_retries.md).
1. En los tipos de destino de la opción **Cola de trabajos por lotes**, EventBridge necesita permiso para enviar eventos al destino. EventBridge puede crear el rol de IAM necesario para que se ejecute la regla. Realice una de las siguientes acciones:
+ Para crear un rol de IAM automáticamente, elija **Creación de un nuevo rol para este recurso específico**.
+ Para utilizar un rol de IAM que haya creado antes, elija **Uso de función existente**.
1. (Opcional) Amplíe **Configuración adicional**.
1. En **Configurar la entrada de destino**, elija cómo se procesa el texto de un evento.
1. En **Antigüedad máxima del evento**, especifique el intervalo de tiempo durante el que se guardan los eventos sin procesar.
1. En **Intentos de reintento**, introduzca el número de veces que se volverá a intentar un evento.
1. En **Cola de mensajes fallidos,** elija una opción para gestionar los eventos no procesados. Si es necesario, especifique la cola de Amazon SQS que se utilizará como la cola de mensajes fallidos.
1. (Opcional) Elija **Agregar otro destino** para agregar otro destino para esta regla.
1. Elija **Siguiente**.
1. (Opcional) En **Etiquetas**, elija **Añadir nueva etiqueta** para añadir una etiqueta de recurso. Para obtener más información, consulte [Etiquetas de Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. En **Revisar y crear**, revise los pasos de configuración. Si necesita realizar cambios, elija **Editar**. Cuando haya terminado, elija **Creación de regla**.
Para obtener más información sobre cómo crear la regla, consulte [Creación de reglas de EventBridge que reaccionan a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) en la *Guía del usuario de Amazon EventBridge*.
# Tutorial: Pase la información del evento a un AWS Batch objetivo según un cronograma utilizando el transformador EventBridge de entrada
Puede usar el transformador EventBridge de entrada para pasar la información del evento al AWS Batch enviar un trabajo. Esto puede resultar especialmente valioso si se invocan trabajos como resultado de otra información sobre eventos de AWS . Un ejemplo es la carga de un objeto en un bucket de Amazon S3. También puede usar una definición de trabajo con valores de sustitución de parámetros en el comando del contenedor. El transformador EventBridge de entrada puede proporcionar los valores de los parámetros en función de los datos del evento.
A continuación, se crea un objetivo de AWS Batch evento que analiza la información del evento que lo inicia y la transforma en un `parameters` objeto. Cuando se ejecuta el trabajo, los parámetros del evento que se desencadena se pasan al comando del contenedor del trabajo.
**nota**
En este escenario, todos los AWS recursos (como los depósitos, EventBridge las reglas y los CloudTrail registros de Amazon S3) deben estar en la misma región.
**Para crear un AWS Batch objetivo que utilice el transformador de entrada**
1. Abre la EventBridge consola de Amazon en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En la barra de navegación, selecciona la Región de AWS que deseas usar.
1. En el panel de navegación, seleccione **Reglas**.
1. Elija **Creación de regla**.
1. En **Nombre**, especifique un nombre único para el entorno de computación. El nombre puede contener hasta 64 caracteres. Puede contener letras mayúsculas y minúsculas, números, guiones (-) y guiones bajos (\$1).
**nota**
Una regla no puede tener el mismo nombre que otra regla en el mismo bus de eventos Región de AWS y en el mismo.
1. (Opcional) En **Descripción**, introduzca una descripción para la regla.
1. En **Bus de eventos**, elija el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, seleccione **predeterminado**. Cuando un Servicio de AWS elemento de tu cuenta emite un evento, siempre va al bus de eventos predeterminado de tu cuenta.
1. (Opcional) Desactive la regla en el bus seleccionado si no desea ejecutarla inmediatamente.
1. En **Tipo de regla**, elija **Programación**.
1. Seleccione **Continuar para crear la regla** o **Siguiente**.
1. En **Programar patrón**, realice una de las siguientes acciones:
+ Elija **Un horario detallado que se ejecute a una hora específica, como las 8:00 a. m. PST el primer lunes de cada mes** y después introduzca la expresión cron. Para obtener más información, consulte [Cron Expressions](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) en la *Guía del EventBridge usuario de Amazon*.
+ Elija **un horario que se ejecute a un ritmo regular, por ejemplo, cada 10 minutos.** y, a continuación, introduzca una expresión de frecuencia.
1. Elija **Siguiente**.
1. En **Tipos de destino**, elija **Servicio de AWS**.
1. En **Seleccione un objetivo**, elija **Cola de trabajos por lotes**. A continuación, configure lo siguiente:
+ **Cola de trabajos**: introduzca el nombre de recurso de Amazon (ARN) de la cola de trabajos en la que va a programar el trabajo.
+ **Definición de trabajo**: introduzca el nombre y la revisión o el ARN completo de la definición de trabajo que va a utilizar para el trabajo.
+ **Nombre de trabajo**: introduzca un nombre para el trabajo.
+ **Tamaño de la matriz**: (opcional) introduzca un tamaño de matriz para que el trabajo ejecute más de una copia. Para obtener más información, consulte [Trabajos de matrices](array_jobs.md).
+ **Intentos de trabajo**: (opcional) introduzca el número de veces que se debe reintentar el trabajo si se produce un error. Para obtener más información, consulte [Reintentos automáticos de trabajo](job_retries.md).
1. Para los tipos de objetivos de **cola de trabajos por lotes**, EventBridge necesita permiso para enviar eventos al destino. EventBridge puede crear la función de IAM necesaria para que se ejecute la regla. Realice una de las siguientes acciones:
+ Para crear un rol de IAM automáticamente, elija **Creación de un nuevo rol para este recurso específico**.
+ Para utilizar un rol de IAM que haya creado antes, elija **Uso de rol existente**.
1. (Opcional) Amplíe **Configuración adicional**.
1. En la sección **Ajustes adicionales**, en **Configurar entrada de destino**, elija **Transformador de entrada**.
1. Elija **Configurar transformador de entrada**.
1. (Opcional) En **Ejemplo de evento**:
1. En **Ejemplo de tipo de evento**, elija **eventos de AWS **.
1. En **Eventos de muestra**, elija **Cambiar estado de trabajo por lotes**.
1. En la sección **Transformador de entrada de destino** en **Ruta de entrada**, especifique los valores que se van a analizar del evento que se desencadena. Por ejemplo, para analizar el evento **Cambiar estado de trabajo por lotes**, utilice el siguiente formato JSON.
```
{
"instance": "$.detail.jobId",
"state": "$.detail.status"
}
```
1. En **Plantilla**, introduzca lo siguiente.
```
{
"instance": ,
"status":
}
```
1. Elija **Confirmar**.
1. En **Antigüedad máxima del evento**, especifique el intervalo de tiempo durante el que se guardan los eventos sin procesar.
1. En **Intentos de reintento**, introduzca el número de veces que se volverá a intentar un evento.
1. En **Cola de mensajes fallidos,** elija una opción para gestionar los eventos no procesados. Si es necesario, especifique la cola de Amazon SQS que se utilizará como la cola de mensajes fallidos.
1. (Opcional) Elija **Agregar otro destino** para agregar otro destino para esta regla.
1. Elija **Siguiente**.
1. (Opcional) En **Etiquetas**, elija **Añadir nueva etiqueta** para añadir una etiqueta de recurso. Para obtener más información, consulta las [ EventBridge etiquetas de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) en la *Guía del EventBridge usuario de Amazon*.
1. Elija **Siguiente**.
1. En **Revisar y crear**, revise los pasos de configuración. Si necesita realizar cambios, elija **Editar**. Cuando haya terminado, elija **Creación de regla**.
# Tutorial: escucha de los eventos de trabajo de AWS Batch con EventBridge
En este tutorial, se configura una función simple AWS Lambda que escucha eventos de trabajo AWS Batch y los escribe en un flujo de registro de los Registros de CloudWatch.
## Requisitos previos
En este tutorial se supone que tiene un entorno de computación y una cola de trabajos que están listos para aceptar trabajos. Si no dispone de un entorno de computación y una cola de trabajos para capturar eventos, siga los pasos de [Cómo empezar con AWS Batch los tutoriales](Batch_GetStarted.md) para crearlos. Al final de este tutorial, puede enviar opcionalmente un trabajo a esta cola de trabajos para comprobar que ha configurado correctamente su función de Lambda.
**Topics**
+ [Requisitos previos](#cwet_prereqs)
+ [Tutorial: creación de la función de Lambda](cwet_create_lam.md)
+ [Tutorial: registro de la regla de eventos](cwet_register_event_rule.md)
+ [Tutorial: prueba de la configuración](cwet_test.md)
# Tutorial: creación de la función de Lambda
En este procedimiento, creará una función de Lambda sencilla que servirá como destino para los mensajes del flujo de eventos de AWS Batch.
**Para crear una función de Lambda de destino**
1. Abra la consola de AWS Lambda en [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).
1. Elija **Create function (Creación de función)** y, a continuación, elija **Author from scratch (Creación de desde cero)**.
1. En **Nombre de función**, introduzca **batch-event-stream-handler**.
1. En **Tiempo de ejecución**, seleccione **Python 3.8**.
1. Seleccione **Creación de función**.
1. En la sección **Código fuente**, edite el código de muestra para que coincida con el siguiente ejemplo:
```
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))
```
Se trata de una función simple de Python 3.8 que imprime los eventos enviados por AWS Batch. Si todo está configurado correctamente, al final de este tutorial verá los detalles de los eventos del flujo de registros de los Registros de CloudWatch asociados a esta función de Lambda.
1. Seleccione **Implementar**.
# Tutorial: registro de la regla de eventos
En esta sección, se crea una regla de evento de EventBridge que captura eventos de trabajos procedentes de sus recursos de AWS Batch. Esta regla captura todos los eventos procedentes de AWS Batch dentro de la cuenta donde se define. Los propios mensajes de trabajo contienen información sobre el origen del evento, incluida la cola de trabajo en la que se envió. Puede utilizar esta información para filtrar y ordenar eventos de manera programática.
**nota**
Si utiliza el Consola de administración de AWS para crear una regla de evento, la consola añade automáticamente los permisos IAM para EventBridge para llamar a su función de Lambda. Sin embargo, si crea una regla de evento utilizando la AWS CLI, tiene que otorgar permisos explícitamente. Para obtener más información, consulte [Eventos y patrones de eventos en EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del usuario de Amazon EventBridge*.
**Para crear su regla EventBridge**
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Reglas**.
1. Elija **Creación de regla**.
1. Escriba un nombre y una descripción para la regla.
Una regla no puede tener el mismo nombre que otra regla de la misma región y del mismo bus de eventos.
1. En **Bus de eventos**, seleccione el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, seleccione **Bus de eventos predeterminado de AWS**. Cuando un servicio de AWS en su cuenta emite un evento, siempre va al bus de eventos predeterminado de su cuenta.
1. En **Tipo de regla**, elija **Regla con un patrón de evento**.
1. Seleccione **Siguiente**.
1. En **Origen del evento**, seleccione **Otro**.
1. En **Patrón de eventos**, seleccione **Patrones personalizados (editor de JSON)**.
1. Pegue el siguiente patrón de eventos en el área de texto.
```
{
"source": [
"aws.batch"
]
}
```
Esta regla se aplica a todos los grupos de AWS Batch y a todos los eventos de AWS Batch. También puede crear una regla más específica para filtrar algunos resultados.
1. Elija **Siguiente**.
1. En **Target types** (Tipos de destino), elija **AWS service**.
1. En **Seleccionar un objetivo**, elija **Función de Lambda** y seleccione su función de Lambda.
1. (Opcional) En **Configuración adicional**, haga lo siguiente:
1. En **Antigüedad máxima del evento**, indique un valor entre un minuto (00:01) y 24 horas (24:00).
1. En **Cantidad de reintentos**, indique un número entre 0 y 185.
1. En **Cola de mensajes falidos**, seleccione si desea utilizar una cola de Amazon SQS estándar como cola de mensajes fallidos. EventBridge envía eventos que coincidan con esta regla a la cola de mensajes fallidos si no se entregan correctamente al destino. Realice una de las siguientes acciones:
+ Seleccione **Ninguna** para no usar una cola de mensajes fallidos.
+ Elija **Seleccionar una cola de Amazon SQS en la cuenta de AWS actual para usarla como cola de mensajes fallidos** y luego seleccione de la lista desplegable la cola que quiera usar.
+ Elija **Seleccionar una cola de Amazon SQS en otra cuenta de AWS como cola de mensajes fallidos** y luego ingrese el ARN de la cola que quiera usar. Debe asociar una política basada en recursos a la cola que conceda permiso a EventBridge para enviarle mensajes. Para obtener más información, consulte [Concesión de permisos a la cola de mensajes fallidos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. (Opcional) Introduzca una o varias etiquetas para la regla. Para obtener más información, consulte [Etiquetas de Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. Revise los detalles de la regla y seleccione **Creación de regla**.
# Tutorial: prueba de la configuración
Ahora puede probar la configuración de EventBridge enviando una tarea a la cola de tareas. Si todo está configurado correctamente, su función de Lambda se activa y escribe los datos de eventos en un flujo de registro de los Registros de CloudWatch para la función.
**Para probar la configuración**
1. Abra la consola AWS Batch en [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Envíe un nuevo trabajo de AWS Batch. Para obtener más información, consulte [Tutorial: envío de un trabajo](submit_job.md).
1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, elija **Logs** (Registros) y seleccione el grupo de registros para la función de Lambda (por ejemplo, **/aws/lambda/***my-function*).
1. Seleccione una secuencia de registro para ver los datos de los eventos.
# Tutorial: envío de alertas de Amazon Simple Notification Service para eventos de trabajos fallidos
En este tutorial, usted configura una regla de evento Amazon EventBridge que sólo captura eventos de trabajo donde el trabajo se ha movido a un estado `FAILED`. Al final de este tutorial, si lo desea, también puede enviar un trabajo a esta cola de trabajos. Esto sirve para comprobar que ha configurado correctamente las alertas de Amazon SNS.
## Requisitos previos
En este tutorial se supone que tiene un entorno de computación y una cola de trabajos que están listos para aceptar trabajos. Si no dispone de un entorno de computación y una cola de trabajos para capturar eventos, siga los pasos de [Cómo empezar con AWS Batch los tutoriales](Batch_GetStarted.md) para crearlos.
**Topics**
+ [Requisitos previos](#batch_sns_prereq)
+ [Tutorial: creación de un tema de Amazon SNS y suscribirse a él](batch_sns_create_topic.md)
+ [Tutorial: registro de una regla de eventos](batch_sns_reg_rule.md)
+ [Tutorial: prueba de la regla](batch_sns_test_rule.md)
+ [Regla alternativa: cola de trabajos por lotes bloqueada](#test_blocked_job_queue)
# Tutorial: creación de un tema de Amazon SNS y suscribirse a él
Para este tutorial, se configura un tema de Amazon SNS para utilizarse como destino de eventos para la nueva regla de eventos.
**Para crear un tema de Amazon SNS**
1. Abra la consola de Amazon SNS en [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).
1. Seleccione **Topics (Temas)**, **Create topic (Creación de tema)**.
1. En **Tipo**, seleccione **Estándar**.
1. Para **Nombre**, escriba **JobFailedAlert** y, a continuación, elija **Creación de tema**.
1. En la pantalla **JobFailedAlert**, elija **Creación de suscripción**.
1. En **Protocolo**, seleccione **Correo electrónico**.
1. En **Endpoint (Punto de conexión)**, ingrese una dirección de email a la que actualmente tenga acceso y elija **Create subscription (Creación de suscripción)**.
1. Consulte su cuenta de correo electrónico y espere para recibir un mensaje de correo electrónico de confirmación de la suscripción. Cuando lo reciba, seleccione **Confirmar suscripción**.
# Tutorial: registro de una regla de eventos
A continuación, registre una regla de eventos que solo capture los eventos de trabajos con error.
**Para registrar su regla de EventBridge**
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Reglas**.
1. Elija **Creación de regla**.
1. Escriba un nombre y una descripción para la regla.
Una regla no puede tener el mismo nombre que otra regla de la misma región y del mismo bus de eventos.
1. En **Bus de eventos**, seleccione el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, seleccione **Bus de eventos predeterminado de AWS**. Cuando un servicio de AWS en su cuenta emite un evento, siempre va al bus de eventos predeterminado de su cuenta.
1. En **Tipo de regla**, elija **Regla con un patrón de evento**.
1. Seleccione **Siguiente**.
1. En **Origen del evento**, seleccione **Otro**.
1. En **Patrón de eventos**, seleccione **Patrones personalizados (editor de JSON)**.
1. Pegue el siguiente patrón de eventos en el área de texto.
```
{
"detail-type": [
"Batch Job State Change"
],
"source": [
"aws.batch"
],
"detail": {
"status": [
"FAILED"
]
}
}
```
Este código define una regla de eventos de EventBridge que coincide con cualquier evento en el que el estado del trabajo sea `FAILED`. Para obtener más información sobre los patrones de eventos, consulte [Eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. En **Tipos de destino**, seleccione **Servicio de AWS**.
1. En **Seleccione un destino**, elija un **tema de SNS** y, en **Tema**, elija **JobFailedAlert**.
1. (Opcional) En **Configuración adicional**, haga lo siguiente:
1. En **Antigüedad máxima del evento**, indique un valor entre un minuto (00:01) y 24 horas (24:00).
1. En **Cantidad de reintentos**, indique un número entre 0 y 185.
1. En **Cola de mensajes falidos**, seleccione si desea utilizar una cola de Amazon SQS estándar como cola de mensajes fallidos. EventBridge envía eventos que coincidan con esta regla a la cola de mensajes fallidos si no se entregan correctamente al destino. Realice una de las siguientes acciones:
+ Seleccione **Ninguna** para no usar una cola de mensajes fallidos.
+ Elija **Seleccionar una cola de Amazon SQS en la cuenta de AWS actual para usarla como cola de mensajes fallidos** y luego seleccione de la lista desplegable la cola que quiera usar.
+ Elija **Seleccionar una cola de Amazon SQS en otra cuenta de AWS como cola de mensajes fallidos** y luego ingrese el ARN de la cola que quiera usar. Debe asociar una política basada en recursos a la cola que conceda permiso a EventBridge para enviarle mensajes. Para obtener más información, consulte [Concesión de permisos a la cola de mensajes fallidos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. (Opcional) Introduzca una o varias etiquetas para la regla. Para obtener más información, consulte [Etiquetas de Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) en la *Guía del usuario de Amazon EventBridge*.
1. Elija **Siguiente**.
1. Revise los detalles de la regla y seleccione **Creación de regla**.
# Tutorial: prueba de la regla
Para probar la regla, envíe un trabajo que se cierre poco después de que comience y tenga un código de salida distinto de cero. Si su regla de eventos está configurada correctamente, debería recibir un mensaje de correo electrónico en unos minutos con el texto del evento.
**Para probar una regla**
1. Abra la consola AWS Batch en [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Envíe un nuevo trabajo de AWS Batch. Para obtener más información, consulte [Tutorial: envío de un trabajo](submit_job.md). Para el comando del trabajo, sustituya este comando para salir del contenedor con un código de salida de 1.
```
/bin/sh, -c, 'exit 1'
```
1. Compruebe su correo electrónico para confirmar que ha recibido una alerta de correo electrónico para la notificación de trabajo fallido.
## Regla alternativa: cola de trabajos por lotes bloqueada
Para crear una regla de eventos que supervise si *la cola de trabajos por lotes está bloqueada*, repita estos tutoriales con las siguientes modificaciones:
1. **En [Tutorial: creación de un tema de Amazon SNS y suscribirse a él](batch_sns_create_topic.md)**, utilice *BlockedJobQueue* como nombre del tema.
1. **En [Tutorial: registro de una regla de eventos](batch_sns_reg_rule.md)**, utilice el siguiente patrón en el editor JSON:
```
{
"detail-type": [
"Batch Job Queue Blocked"
],
"source": [
"aws.batch"
]
}
```