As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Stream de evento AWS Batch para o Amazon EventBridge
É possível usar o fluxo de eventos do AWS Batch para o Amazon EventBridge para receber notificações quase em tempo real sobre o estado atual de trabalhos em suas filas de trabalho.
Você pode usar o EventBridge para obter mais informações sobre seu serviço AWS Batch. Mais especificamente, você pode usá-lo para verificar o progresso dos trabalhos, criar fluxos de trabalho personalizados AWS Batch, gerar relatórios ou métricas de uso ou criar seus próprios painéis. Com o AWS Batch e o EventBridge, você não precisa da programação e do monitoramento do código que consulta continuamente o AWS Batch em busca de alterações no status do trabalho. Em vez disso, você pode lidar com mudanças no estado do trabalho AWS Batch de forma assíncrona usando uma variedade de destinos do Amazon EventBridge. Os destinos podem incluir AWS Lambda, Amazon Simple Queue Service, Amazon Simple Notification Service ou Amazon Kinesis Data Streams.
Os eventos do fluxo de eventos do AWS Batch serão entregues pelo menos uma vez. Caso eventos duplicados sejam enviados, o evento fornece informações o suficiente para identificar cópias. Dessa forma, você pode comparar a data e hora do evento e o status do trabalho.
Os trabalhos AWS Batch estão disponíveis como destinos do EventBridge. Usando regras simples você pode corresponder a eventos e enviar trabalhos do AWS Batch em resposta a esses eventos. Para obter mais informações, consulte [What is EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) no *Guia do usuário do Amazon EventBridge*. Você também pode usar o EventBridge para programar ações automatizadas que são acionadas automaticamente em determinados momentos usando **cron** ou expressões de taxa. Para obter mais informações, consulte [Creating an Amazon EventBridge rule that runs on a schedule](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) no *Amazon EventBridge User Guide*. Para ver uma demonstração de exemplo, consulte [Trabalhos AWS Batch como destinos do EventBridge](batch-cwe-target.md). Para obter informações sobre o uso do EventBridge Scheduler, consulte [Configurando o Agendador do Amazon EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html) no Guia do usuário do Amazon EventBridge.
**Topics**
+ [
# AWS Batch eventos
](batch_cwe_events.md)
+ [
# Tutorial: use notificações AWS do usuário com AWS Batch
](using-user-notifications.md)
+ [
# Trabalhos AWS Batch como destinos do EventBridge
](batch-cwe-target.md)
+ [
# Tutorial: recepcionar eventos de trabalho do AWS Batch usando o EventBridge
](batch_cwet.md)
+ [
# Tutorial: Como enviar alertas do Amazon Simple Notification Service para eventos de trabalho que falharam
](batch_sns_tutorial.md)
# AWS Batch eventos
AWS Batch envia eventos de alteração do status do trabalho para EventBridge. AWS Batch monitora o estado de seus empregos. Se o status de um trabalho enviado anteriormente mudar, um evento será invocado. Por exemplo, se um trabalho no status `RUNNING` passar para o status `FAILED`. Esses eventos são classificados como eventos de alteração do estado de trabalho.
**nota**
AWS Batch pode adicionar outros tipos de eventos, fontes e detalhes no futuro. Caso você esteja desserializando programaticamente dados JSON do evento, certifique-se de que a aplicação esteja preparada para lidar com propriedades desconhecidas. Isso é para evitar problemas se e quando essas propriedades adicionais forem adicionadas.
# Eventos de alteração de estado do trabalho
Toda vez que um trabalho (enviado anteriormente) mudar de estado, um evento será criado. Para obter mais informações sobre os estados de trabalho do AWS Batch, consulte [Estados do trabalho](job_states.md).
**nota**
Os eventos não são criados para o envio de trabalho inicial.
**Example Evento de alteração de estado do trabalho**
Os eventos de alteração do estado da tarefa são entregues no formato a seguir. A seção `detail` se assemelha ao objeto da [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html) retornado de uma operação de API [DescribeTasks](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html) na *AWS Batch API Reference*. Para obter mais informações sobre os parâmetros do EventBridge, consulte [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Amazon EventBridge User Guide*.
```
{
"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 da fila de trabalhos
Sempre que AWS Batch detectar um trabalho no `RUNNABLE` estado e, assim, bloquear uma fila, um evento é criado no Amazon Events. CloudWatch Para obter mais informações sobre as causas com suporte de filas bloqueadas, consulte [Trabalhos presos no status `RUNNABLE`](job_stuck_in_runnable.md). O mesmo motivo também está disponível no campo `statusReason` na ação da 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 da fila de trabalhos**
Os eventos bloqueados da fila de trabalho são entregues no formato a seguir. A `detail` seção é semelhante ao [JobDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobDetail.html)objeto retornado de uma operação de [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API na *Referência da AWS Batch API*. Para obter mais informações sobre EventBridge parâmetros, consulte [Eventos e padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Guia EventBridge do usuário da 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 alteração de estado do trabalho de serviço
Toda vez que um serviço existente mudar de estado, um evento será criado. Para obter mais informações sobre estados de trabalho de serviço, consulte [Mapeando AWS Batch o status do trabalho do serviço para o status de SageMaker IA](service-job-status.md).
**nota**
Os eventos não são criados para o envio de trabalho inicial.
**Example Eventos de alteração de estado do trabalho de serviço**
Os eventos de alteração do estado de trabalho de serviço são entregues no formato a seguir. A seção `detail` se assemelha à resposta que é retornada de uma operação de API [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html) na *Referência de API AWS Batch*. Para obter mais informações sobre os parâmetros do EventBridge, consulte [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Amazon EventBridge User Guide*.
Os campos `tags` e `serviceRequestPayload` não estão incluídos no 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 da fila de trabalhos de serviço
Sempre que AWS Batch detecta uma fila bloqueada, um evento é criado no Amazon Events. CloudWatch O motivo da fila bloqueada está disponível no campo `statusReason` na ação da 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 da fila de trabalhos de serviço**
Os eventos bloqueados da fila de trabalho de serviço são entregues no formato a seguir. A `detail` seção é semelhante à resposta que é retornada da operação da [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)API na *Referência da AWS Batch API*. Para obter mais informações sobre EventBridge parâmetros, consulte [Eventos e padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Guia EventBridge do usuário da Amazon*.
Os campos `tags` e `serviceRequestPayload` não estão incluídos no 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 preempção de emprego em serviços
Os eventos de preempção são publicados sempre que uma sequência de preempção é iniciada ou concluída. Um evento iniciado é criado quando a preempção é acionada pela primeira vez para recuperar a capacidade emprestada. Um evento concluído é criado quando a sequência de preempção termina e inclui um resumo das tentativas antecipadas.
**Example Evento iniciado pelo Service Job Preemption**
Os eventos iniciados pela preempção do trabalho de serviço são entregues no seguinte formato. Para obter mais informações sobre EventBridge parâmetros, consulte [Eventos e padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Guia EventBridge do usuário da 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 concluído de Service Job Preemption**
Os eventos concluídos de preempção do trabalho de serviço são entregues no seguinte formato. O `preemptionSummary` campo contém detalhes sobre as tentativas antecipadas, incluindo a contagem e as informações mais recentes da tentativa antecipada.
```
{
"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: use notificações AWS do usuário com AWS Batch
Você pode usar as [notificações de usuários da AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) para configurar canais de entrega para receber notificações sobre eventos do AWS Batch . Você recebe uma notificação quando um evento corresponde a uma regra especificada. É possível receber notificações para eventos por meio de diversos canais, incluindo o e-mail, o [Amazon Q Developer em aplicações de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), notificações por chat ou notificações push do [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html). Você também pode ver as notificações na [Central de notificações do console](https://console.aws.amazon.com/notifications/). As notificações do usuário permitem agregação, o que pode reduzir o número de notificações recebidas durante eventos específicos.
Para configurar as notificações do usuário em AWS Batch:
1. Abra o [console do AWS Batch](https://console.aws.amazon.com/batch/home).
1. Escolha **Painel**.
1. Escolha **Configurar notificações**.
1. Em **Notificações AWS do usuário**, escolha **Criar configuração de notificação**.
Para obter mais informações sobre como configurar e visualizar as notificações do usuário, consulte [Introdução às notificações AWS do usuário](https://docs.aws.amazon.com/notifications/latest/userguide/getting-started.html).
# Trabalhos AWS Batch como destinos do EventBridge
O Amazon EventBridge oferece um fluxo quase em tempo quase real dos eventos do sistema que descrevem as alterações nos recursos da Amazon Web Services. Em geral, AWS Batch no Amazon Elastic Container Service, no Amazon Elastic Kubernetes Service e no AWS Fargate, os trabalhos estão disponíveis como destinos do EventBridge. Usando regras simples você pode corresponder a eventos e enviar trabalhos do AWS Batch em resposta a esses eventos. Para obter mais informações, consulte [What is EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) no *Guia do usuário do Amazon EventBridge*.
Também é possível usar o EventBridge para programar ações automatizadas que são acionadas automaticamente em determinados momentos usando expressões **cron** ou rate. Para obter mais informações, consulte [Creating an Amazon EventBridge rule that runs on a schedule](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) no *Amazon EventBridge User Guide*.
Para obter informações sobre como criar uma regra quando um evento corresponder com um padrão de evento, consulte [Creating Amazon EventBridge rules that react to events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) no *Guia do usuário do Amazon EventBridge*.
Os casos de uso comuns para trabalhos AWS Batch como alvo do EventBridge incluem os seguintes casos de uso:
+ Um trabalho agendado ocorre em intervalos de tempo regulares. Por exemplo, um trabalho **cron** ocorre somente em horários de baixa utilização, quando as Instâncias Spot do Amazon EC2 são mais baratas.
+ Um trabalho AWS Batch é executado em resposta a uma operação de API registrada no CloudTrail. Por exemplo, um trabalho é enviado sempre que um objeto é carregado em um bucket específico do Amazon S3. Sempre que isso acontece, o transformador de entrada EventBridge passa o bucket e o nome da chave do objeto para os parâmetros AWS Batch.
**nota**
Nesse cenário, todos os recursos AWS relacionados devem estar na mesma região. Isso inclui recursos como o bucket do Amazon S3, a regra do EventBridge e os registros do CloudTrail.
Antes que você possa enviar trabalhos AWS Batch com regras e destinos do EventBridge, o serviço do CloudWay Events exige várias permissões para executar trabalhos. AWS Batch Ao criar uma regra no console do EventBridge que especifica um trabalho do AWS Batch como destino, você tem a oportunidade de criar esse perfil. Para obter mais informações sobre a entidade principal do serviço e as permissões do IAM necessárias para esse perfil, consulte [EventBridge IAM role (Função do IAM)](CWE_IAM_role.md).
**Topics**
+ [
# Tutorial: criar um trabalho programado do AWS Batch
](scheduled-batch-job.md)
+ [
# Tutorial: criar uma regra com um padrão de evento
](event-pattern-batch-job.md)
+ [
# Tutorial: Passe informações do evento para um AWS Batch alvo em um cronograma usando o transformador EventBridge de entrada
](cwe-input-transformer.md)
# Tutorial: criar um trabalho programado do AWS Batch
O procedimento a seguir aborda como criar um trabalho AWS Batch programado e o perfil necessário do IAM do EventBridge.
**Para criar um trabalho programado do AWS Batch com o EventBridge**
**nota**
Esse procedimento funciona para todos os trabalhos AWS Batch do Amazon ECS, Amazon EKS e AWS Fargate.
1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Na barra de navegação, selecione Região da AWS a ser usada.
1. No painel de navegação, escolha **Regras**.
1. Escolha **Criar Regra**.
1. Para **Nome**, especifique um nome exclusivo para seu ambiente de computação. O nome pode conter até 64 caracteres. Pode conter letras minúsculas, maiúsculas, números, hifens e (-) e sublinhados (\$1).
**nota**
Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos.
1. (Opcional) Em **Description**, insira uma descrição para a regra.
1. Em **Barramento de Eventos**, escolha o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, selecione **default**. Quando um AWS service (Serviço da AWS) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.
1. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente.
1. Em **Rule type**, escolha **Schedule**.
1. Escolha **Continuar para criar a regra** ou **Avançar**.
1. Em **Schedule pattern**, siga um destes procedimentos:
+ Escolha **um cronograma refinado que seja executado em um horário específico, tal como 8:00 a.m. PST na primeira segunda-feira de cada mês** e insira a expressão cron. Para obter mais informações, consulte [Expressões Cron](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) no *Guia do usuário do Amazon EventBridge*.
+ Escolha **uma programação que seja executada em uma taxa regular, como a cada 10 minutos.** e, em seguida, insira uma expressão rate.
1. Escolha **Next** (Próximo).
1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**.
1. Em **Selecionar um destino**, escolha **Fila de trabalhos em lote**. Em seguida, configure o seguinte:
+ **Job queue:** (Fila de trabalhos:), insira nome do recurso da Amazon (ARN) da fila de trabalhos na qual o trabalho será programado.
+ **Job definition:** (Definição do trabalho:) insira o nome e a revisão ou ARN completo da definição do trabalho a ser usado.
+ **Job name:** (Nome do trabalho:) insira um nome para o trabalho.
+ **Array size:** (Tamanho da matriz:) (opcional) insira um tamanho de matriz para que o trabalho execute mais de uma cópia. Para obter mais informações, consulte [Trabalhos de matriz](array_jobs.md).
+ **Job attempts:** (opcional) insira o número de vezes para tentar novamente caso ocorra uma falha no trabalho. Para obter mais informações, consulte [Repetições de trabalho automatizadas](job_retries.md).
1. Para os tipos de destino **Batch job queue** (Fila de trabalhos em lote), o Eventbridge precisa de permissão para enviar eventos ao destino. Nesses casos, o Eventbridge pode criar o perfil do IAM necessário para a função ser executada. Execute um destes procedimentos:
+ Para criar um perfil do IAM automaticamente, escolha **Create a new role for this specific resource**.
+ Para usar uma função do IAM que você criou anteriormente, escolha **Usar função existente**.
1. (Opcional) Expanda **Additional settings**.
1. Em **Configurar entrada de destino**, escolha como o texto de um evento é processado antes de ser passado para o destino.
1. Em **Idade máxima do evento**, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos.
1. Em **Tentativas de repetição**, insira o número de vezes que um evento é repetido.
1. Em **Dead-letter queue,** escolha uma opção de como os eventos não processados são tratados. Se necessário, especifique a fila do Amazon SQS para usar como fila de mensagens mortas.
1. (Opcional) Selecione **Add another target** para adicionar outro destino a essa regra.
1. Escolha **Next** (Próximo).
1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** para adicionar um rótulo de recurso à regra. Para obter mais informações, consulte [tags do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html).
1. Escolha **Next** (Próximo).
1. Para **Revisar e criar**, revise as etapas de configuração. Se precisar fazer alterações, escolha **Edit** (Editar). Quando terminar, escolha **Create rule**.
Para obter mais informações sobre como criar regras de eventos, consulte [Creating an Amazon EventBridge rule that runs on a schedule](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) no *Guia do usuário do Amazon EventBridge*.
# Tutorial: criar uma regra com um padrão de evento
O procedimento a seguir aborda como criar uma regra com um padrão de evento.
**Para criar uma regra que envie o evento para um destino quando o evento corresponder a um padrão definido**
**nota**
Esse procedimento funciona para todos os trabalhos AWS Batch do Amazon ECS, Amazon EKS e AWS Fargate.
1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Na barra de navegação, selecione Região da AWS a ser usada.
1. No painel de navegação, escolha **Regras**.
1. Escolha **Criar Regra**.
1. Para **Nome**, especifique um nome exclusivo para seu ambiente de computação. O nome pode conter até 64 caracteres. Pode conter letras minúsculas, maiúsculas, números, hifens e (-) e sublinhados (\$1).
**nota**
Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos.
1. (Opcional) Em **Description**, insira uma descrição para a regra.
1. Em **Barramento de Eventos**, escolha o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, selecione **default**. Quando um AWS service (Serviço da AWS) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.
1. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente.
1. Em **Rule type**, escolha **Rule with an event pattern**.
1. Escolha **Próximo**.
1. Em **Event source**, escolha **Eventos da AWS ou eventos de parceiro do EventBridge**.
1. (Opcional) Para **evento de amostra**:
1. Em **Tipo de evento de amostra**, escolha **AWSeventos**.
1. Em **Eventos de amostra**, escolha **Batch Job State Change**.
1. Em **Creation method**, escolha **Use pattern form**.
1. Para **padrão de eventos**:
1. Em **Event source**, escolha **Serviços da AWS**.
1. Em **AWS service (Serviço da AWS)**, escolha **Batch**.
1. Em **Event type**, escolha **Batch Job State Change**.
1. Escolha **Next** (Próximo).
1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**.
1. Em **Choose a target type**, selecione o tipo de destino. Por exemplo, escolha **Batch job queue**. Em seguida, especifique o seguinte:
+ **Job queue:** (Fila de trabalhos:), insira nome do recurso da Amazon (ARN) da fila de trabalhos na qual o trabalho será programado.
+ **Job definition:** (Definição do trabalho:) insira o nome e a revisão ou ARN completo da definição do trabalho a ser usado.
+ **Job name:** (Nome do trabalho:) insira um nome para o trabalho.
+ **Array size:** (Tamanho da matriz:) (opcional) insira um tamanho de matriz para que o trabalho execute mais de uma cópia. Para obter mais informações, consulte [Trabalhos de matriz](array_jobs.md).
+ **Job attempts:** (opcional) insira o número de vezes para tentar novamente caso ocorra uma falha no trabalho. Para obter mais informações, consulte [Repetições de trabalho automatizadas](job_retries.md).
1. Para os tipos de destino **Batch job queue** (Fila de trabalhos em lote), o Eventbridge precisa de permissão para enviar eventos ao destino. Nesses casos, o Eventbridge pode criar o perfil do IAM necessário para a função ser executada. Execute um destes procedimentos:
+ Para criar um perfil do IAM automaticamente, escolha **Create a new role for this specific resource**.
+ Para usar um perfil do IAM que você criou antes, escolha **Use existing role**.
1. (Opcional) Expanda **Additional settings**.
1. Em **Configure target input**, escolha como o texto de um evento é processado.
1. Em **Idade máxima do evento**, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos.
1. Em **Tentativas de repetição**, insira o número de vezes que um evento é repetido.
1. Em **Dead-letter queue,** escolha uma opção de como os eventos não processados são tratados. Se necessário, especifique a fila do Amazon SQS para usar como fila de mensagens mortas.
1. (Opcional) Selecione **Add another target** (Adicionar outro destino) para adicionar outro destino a essa regra.
1. Escolha **Next** (Próximo).
1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** para adicionar um rótulo de recurso. Para mais informações, consulte [Tags Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) em *Guia de Usuário Amazon EventBridge*.
1. Escolha **Next** (Próximo).
1. Para **Revisar e criar**, revise as etapas de configuração. Se precisar fazer alterações, escolha **Edit** (Editar). Quando terminar, escolha **Create rule**.
Para obter informações sobre como criar regras, consulte [Criar regras do Amazon EventBridge que reagem a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) no *Guia do usuário do Amazon EventBridge*.
# Tutorial: Passe informações do evento para um AWS Batch alvo em um cronograma usando o transformador EventBridge de entrada
Você pode usar o transformador EventBridge de entrada para transmitir informações do evento AWS Batch em um envio de trabalho. Isso pode ser especialmente valioso se você invocar trabalhos como resultado de outras informações do evento AWS . Um exemplo é upload de objeto para um bucket do Amazon S3. Você também pode usar uma definição de tarefa com valores de substituição de parâmetros no comando do contêiner. O transformador EventBridge de entrada pode fornecer os valores dos parâmetros com base nos dados do evento.
Depois, você cria um destino de AWS Batch evento que analisa as informações do evento que o inicia e as transforma em um `parameters` objeto. Quando o trabalho é executado, os parâmetros do evento do acionador são repassados para o comando do contêiner do trabalho.
**nota**
Nesse cenário, todos os AWS recursos (como buckets, EventBridge regras e CloudTrail registros do Amazon S3) devem estar na mesma região.
**Para criar um AWS Batch alvo que usa o transformador de entrada**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Na barra de navegação, selecione o Região da AWS a ser usado.
1. No painel de navegação, escolha **Regras**.
1. Escolha **Criar Regra**.
1. Para **Nome**, especifique um nome exclusivo para seu ambiente de computação. O nome pode conter até 64 caracteres. Pode conter letras minúsculas, maiúsculas, números, hifens e (-) e sublinhados (\$1).
**nota**
Uma regra não pode ter o mesmo nome de outra regra no mesmo barramento de eventos Região da AWS e no mesmo.
1. (Opcional) Em **Description**, insira uma descrição para a regra.
1. Em **Barramento de Eventos**, escolha o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, selecione **padrão**. Quando um AWS service (Serviço da AWS) em sua conta emite um evento, ele sempre vai para o ônibus de eventos padrão da sua conta.
1. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente.
1. Em **Rule type**, escolha **Schedule**.
1. Escolha **Continuar para criar a regra** ou **Avançar**.
1. Em **Schedule pattern**, siga um destes procedimentos:
+ Escolha **um cronograma refinado que seja executado em um horário específico, tal como 8:00 a.m. PST na primeira segunda-feira de cada mês** e insira a expressão cron. Para obter mais informações, consulte [Expressões Cron](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) no *Guia do EventBridge usuário da Amazon*.
+ Escolha **uma programação que seja executada em uma taxa regular, como a cada 10 minutos.** e, em seguida, insira uma expressão rate.
1. Escolha **Next** (Próximo).
1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**.
1. Em **Selecionar um destino**, escolha **Fila de trabalhos em lote**. Em seguida, configure o seguinte:
+ **Fila de trabalhos:** insira nome do recurso da Amazon (ARN) da fila de trabalhos na qual o trabalho será programado.
+ **Definição do trabalho:** insira o nome e a revisão ou ARN completo da definição do trabalho a ser usado.
+ **Nome do trabalho:** insira um nome para o trabalho.
+ **Tamanho da matriz:** (opcional) insira um tamanho de matriz para que o trabalho execute mais de uma cópia. Para obter mais informações, consulte [Trabalhos de matriz](array_jobs.md).
+ **Job attempts:** (opcional) insira o número de vezes para tentar novamente caso ocorra uma falha no trabalho. Para obter mais informações, consulte [Repetições de trabalho automatizadas](job_retries.md).
1. Para tipos de destino de **fila de trabalhos em Batch**, EventBridge precisa de permissão para enviar eventos para o destino. EventBridge pode criar a função do IAM necessária para que sua regra seja executada. Execute um destes procedimentos:
+ Para criar um perfil do IAM automaticamente, escolha **Create a new role for this specific resource**.
+ Para usar uma função do IAM que você criou anteriormente, escolha **Usar função existente**.
1. (Opcional) Expanda **Additional settings**.
1. Na seção **Additional settings**, para **Configure target input**, escolha **Input Transformer**.
1. Escolha **Configure input transformer**.
1. (Opcional) Para **evento de amostra**:
1. Em **Tipo de evento de amostra**, escolha **AWS eventos**.
1. Em **Eventos de amostra**, escolha **Batch Job State Change**.
1. Na seção **Target input transformer**, para **Input path**, especifique os valores a serem analisados no evento de acionamento. Por exemplo, para analisar o evento **Batch Job State Change**, use o seguinte formato JSON.
```
{
"instance": "$.detail.jobId",
"state": "$.detail.status"
}
```
1. Em **Template**, insira o seguinte:
```
{
"instance": ,
"status":
}
```
1. Escolha **Confirmar**.
1. Em **Idade máxima do evento**, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos.
1. Em **Tentativas de repetição**, insira o número de vezes que um evento é repetido.
1. Em **Dead-letter queue,** escolha uma opção de como os eventos não processados são tratados. Se necessário, especifique a fila do Amazon SQS para usar como fila de mensagens mortas.
1. (Opcional) Selecione **Add another target** (Adicionar outro destino) para adicionar outro destino a essa regra.
1. Escolha **Next** (Próximo).
1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** para adicionar um rótulo de recurso. Para obter mais informações, consulte as [ EventBridge tags da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) no *Guia EventBridge do usuário da Amazon*.
1. Escolha **Próximo**.
1. Para **Revisar e criar**, revise as etapas de configuração. Se precisar fazer alterações, escolha **Edit** (Editar). Quando terminar, escolha **Create rule**.
# Tutorial: recepcionar eventos de trabalho do AWS Batch usando o EventBridge
Neste tutorial, você irá configurar uma AWS Lambda função simples para receptar AWS Batch eventos de trabalho e registrá-los em um fluxo de logs CloudWatch Logs.
## Pré-requisitos
Este tutorial pressupõe um ambiente de computação e uma fila de tarefas prontas para aceitar tarefas. Caso você não tenha um ambiente de computação e fila de trabalho em execução do qual capturar eventos, siga as etapas em [Introdução aos AWS Batch tutoriais](Batch_GetStarted.md) para criar um. Ao final deste tutorial, você poderá enviar opcionalmente uma tarefa para essa fila e testar se configurou a função do Lambda corretamente.
**Topics**
+ [
## Pré-requisitos
](#cwet_prereqs)
+ [
# Tutorial: criar a função do Lambda
](cwet_create_lam.md)
+ [
# Tutorial: registrar a regra do evento
](cwet_register_event_rule.md)
+ [
# Tutorial: testar sua configuração
](cwet_test.md)
# Tutorial: criar a função do Lambda
Neste procedimento, você criará uma função do Lambda simples para funcionar como destino AWS Batch de mensagens do fluxo de eventos.
**Para criar uma função do Lambda de destino**
1. Abra o console AWS Lambda em [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).
1. Escolha **Criar Função** e, em seguida, **Criar do Início**.
1. Para **Nome da Função**, insira **batch-event-stream-handler**.
1. Para**Runtime**, escolha **Python 3.8**.
1. Escolha **Criar Função**.
1. Na seção **Fonte do Código**, edite o código de amostra de acordo com o exemplo a seguir:
```
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))
```
Essa é uma função Python 3.8 simples, que imprime eventos enviados por AWS Batch. Se tudo estiver configurado corretamente, no final deste tutorial, os detalhes do evento aparecerão no fluxo de log do CloudWatch Logs associado a essa função do Lambda.
1. Escolha **Implantar**.
# Tutorial: registrar a regra do evento
Nesta seção, você criará uma regra de evento EventBridge que captura eventos de trabalho vindos dos seus recursos AWS Batch. Esta regra captura todos os eventos vindos de AWS Batch dentro da conta na qual estiver definida. As próprias mensagens de trabalho contêm informações sobre a origem do evento, inclusive fila de trabalhos onde foi inserido. Você pode usar essa informação para filtrar e classificar eventos de forma programática.
**nota**
Caso use o Console de gerenciamento da AWS para criar uma regra de evento, o console adicionará automaticamente as permissões do IAM ao EventBridge para chamar sua função do Lambda. No entanto, se criar uma regra de evento usando AWS CLI, você deverá conceder permissões explicitamente. Para mais informações, consulte [Eventos e Padrões de Evento](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Guia de Usuário Amazon EventBridge*.
**Para criar sua regra EventBridge**
1. Abra o console Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Regras**.
1. Escolha **Create rule**.
1. Insira um nome e uma descrição para a regra.
Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos.
1. Em **Barramento de eventos**, selecione o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, escolha **Barramento de eventos padrão da AWS**. Quando um serviço AWS em sua conta emite um evento, ele sempre irá para o barramento de eventos padrão da conta.
1. Em **Tipo de Regra**, escolha **Regra com Padrão de Evento**.
1. Escolha **Próximo**.
1. Em **Origem do Evento**, escolha **Outro**.
1. Em **Padrão de eventos**, selecione **Padrões personalizados (editor JSON)**.
1. Cole o padrão de evento a seguir na área de texto.
```
{
"source": [
"aws.batch"
]
}
```
Essa regra se aplica a todos os grupos AWS Batch e a cada evento AWS Batch. Como alternativa, você pode criar uma regra mais específica para filtrar resultados.
1. Escolha **Próximo**.
1. Em **Tipos de Destino**, escolha **AWS Serviço**.
1. Em **Selecionar um Destino**, escolha **Função do Lambda** e selecione sua função.
1. (Opcional) Para **Configurações Adicionais**, proceda da seguinte forma:
1. Em **Tempo Máximo do Evento**, insira um valor entre um minuto (00:01) e 24 horas (24:00).
1. Em **Tentativas de Repetição**, insira um número entre 0 e 185.
1. Em **Fila de mensagens não entregues**, escolha se será usada uma fila padrão do Amazon SQS como fila de mensagens não entregues. O EventBridge enviará eventos que correspondam a essa regra para a fila de mensagens não entregues caso não sejam entregues com êxito ao destino. Faça um dos procedimentos a seguir:
+ Escolha **Nenhum** para não usar uma fila de mensagens não entregues.
+ Escolha **Selecionar uma Fila Amazon SQS na Conta AWS Atual para usá-la como fila de mensagens não entregues** e então, na lista suspensa, selecione a fila a ser usada.
+ Escolha **Selecionar uma Fila Amazon SQS em qualquer outra AWS conta como fila de mensagens não entregues** e insira o ARN da fila a ser usada. Você deve anexar uma política baseada em recurso à fila responsável por conceder permissão ao EventBridge para enviar mensagens. Para mais informações, consulte [Concedendo Permissões à Fila de Mensagens Não Entregues](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) do *Guia de usuário Amazon EventBridge*.
1. Escolha **Próximo**.
1. (Opcional) Insira uma ou mais tags para a regra. Para mais informações, consulte [Tags Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) em *Guia de Usuário Amazon EventBridge*.
1. Escolha **Próximo**.
1. Analise os detalhes da regra e escolha **Criar Regra**.
# Tutorial: testar sua configuração
Agora, você pode testar sua configuração EventBridge enviando uma tarefa para a fila de tarefas. Se tudo for configurado corretamente, sua função do Lambda será acionada e registrará os dados de eventos em um fluxo de logs CloudWatch Logs para a função.
**Para testar sua configuração**
1. Abra o console AWS Batch em [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Insira uma nova AWS Batch tarefa. Para mais informações, consulte [Tutorial: enviar um trabalho](submit_job.md).
1. Abra o console CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, escolha **Logs** e selecione o grupo de logs para sua função do Lambda (por exemplo, **/aws/lambda/***my-function*).
1. Selecione um fluxo de log para visualizar os dados do evento.
# Tutorial: Como enviar alertas do Amazon Simple Notification Service para eventos de trabalho que falharam
Neste tutorial, você configura uma regra de evento do Amazon EventBridge que apenas captura eventos de trabalho em que o trabalho foi alterado para um status de `FAILED`. No final deste tutorial, você pode optar por enviar um trabalho para essa fila de trabalhos. Isso serve para testar se você configurou seus alertas do Amazon SNS corretamente.
## Pré-requisitos
Este tutorial pressupõe um ambiente de computação e uma fila de tarefas prontas para aceitar tarefas. Caso você não tenha um ambiente de computação e fila de trabalho em execução do qual capturar eventos, siga as etapas em [Introdução aos AWS Batch tutoriais](Batch_GetStarted.md) para criar um.
**Topics**
+ [
## Pré-requisitos
](#batch_sns_prereq)
+ [
# Tutorial: criar e assinar um tópico do Amazon SNS
](batch_sns_create_topic.md)
+ [
# Tutorial: registrar uma regra de evento
](batch_sns_reg_rule.md)
+ [
# Tutorial: testar sua regra
](batch_sns_test_rule.md)
+ [
## Regra alternativa: fila de trabalhos em lote bloqueada
](#test_blocked_job_queue)
# Tutorial: criar e assinar um tópico do Amazon SNS
Neste tutorial, você configura um tópico do Amazon SNS para funcionar como um destino de evento para a nova regra de evento.
**Para criar um tópico do Amazon SNS**
1. Abra o console do Amazon SNS em [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).
1. Escolha **Topics (Tópicos)**, **Create topic (Criar tópico)**.
1. Em **Tipo**, escolha **Padrão**.
1. Em **Nome**, insira **JobFailedAlert** e selecione **Criar tópico**.
1. Na tela **JobFailedAlert**, escolha **Criar assinatura**.
1. Em **Protocolo**, escolha **Email**.
1. Em **Endpoint**, insira um endereço de e-mail ao qual tenha acesso e escolha **Criar assinatura**.
1. Verifique sua conta de e-mail e espere para receber uma mensagem de e-mail de confirmação de assinatura. Quando você recebê-la, escolha **Confirmar assinatura**.
# Tutorial: registrar uma regra de evento
Em seguida, registre uma regra de evento que captura apenas eventos com falha de trabalho.
**Para registrar sua regra do EventBridge**
1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Regras**.
1. Escolha **Create rule**.
1. Insira um nome e uma descrição para a regra.
Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos.
1. Em **Barramento de eventos**, selecione o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, escolha **Barramento de eventos padrão da AWS**. Quando um serviço AWS em sua conta emite um evento, ele sempre irá para o barramento de eventos padrão da conta.
1. Em **Tipo de Regra**, escolha **Regra com Padrão de Evento**.
1. Escolha **Próximo**.
1. Em **Origem do Evento**, escolha **Outro**.
1. Em **Padrão de eventos**, selecione **Padrões personalizados (editor JSON)**.
1. Cole o padrão de evento a seguir na área de texto.
```
{
"detail-type": [
"Batch Job State Change"
],
"source": [
"aws.batch"
],
"detail": {
"status": [
"FAILED"
]
}
}
```
Esse código define uma regra de evento do EventBridge que corresponde a qualquer evento em que o status do trabalho é `FAILED`. Para obter mais informações sobre padrões de eventos, consulte [Eventos e padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Guia do usuário do Amazon EventBridge*.
1. Escolha **Próximo**.
1. Em **Tipos de destino**, escolha **Serviço da AWS**.
1. Em **Selecionar destino**, escolha **Tópico SNS** e, em **Tópico**, escolha **JobFailedAlert**.
1. (Opcional) Para **Configurações Adicionais**, proceda da seguinte forma:
1. Em **Tempo Máximo do Evento**, insira um valor entre um minuto (00:01) e 24 horas (24:00).
1. Em **Tentativas de Repetição**, insira um número entre 0 e 185.
1. Em **Fila de mensagens não entregues**, escolha se será usada uma fila padrão do Amazon SQS como fila de mensagens não entregues. O EventBridge enviará eventos que correspondam a essa regra para a fila de mensagens não entregues caso não sejam entregues com êxito ao destino. Faça um dos procedimentos a seguir:
+ Escolha **Nenhum** para não usar uma fila de mensagens não entregues.
+ Escolha **Selecionar uma Fila Amazon SQS na Conta AWS Atual para usá-la como fila de mensagens não entregues** e então, na lista suspensa, selecione a fila a ser usada.
+ Escolha **Selecionar uma Fila Amazon SQS em qualquer outra AWS conta como fila de mensagens não entregues** e insira o ARN da fila a ser usada. Você deve anexar uma política baseada em recurso à fila responsável por conceder permissão ao EventBridge para enviar mensagens. Para mais informações, consulte [Concedendo Permissões à Fila de Mensagens Não Entregues](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html#eb-dlq-perms) do *Guia de usuário Amazon EventBridge*.
1. Escolha **Próximo**.
1. (Opcional) Insira uma ou mais tags para a regra. Para mais informações, consulte [Tags Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) em *Guia de Usuário Amazon EventBridge*.
1. Escolha **Próximo**.
1. Analise os detalhes da regra e selecione **Criar regra**.
# Tutorial: testar sua regra
Para testar sua regra, envie um trabalho que saia logo após começar com um código de saída diferente de zero. Caso a regra de evento esteja configurada corretamente, você deverá receber uma mensagem de e-mail em alguns minutos com o texto do evento.
**Para testar uma regra**
1. Abra o console AWS Batch em [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Insira uma nova AWS Batch tarefa. Para obter mais informações, consulte [Tutorial: enviar um trabalho](submit_job.md). Para o comando do trabalho, substitua este comando para sair do contêiner com um código de saída 1.
```
/bin/sh, -c, 'exit 1'
```
1. Verifique seu e-mail para confirmar que você recebeu um e-mail de alerta para a notificação de trabalho com falha.
## Regra alternativa: fila de trabalhos em lote bloqueada
Para criar uma regra de evento que monitore a *fila de trabalhos em lote bloqueados*, repita esses tutoriais com as alterações a seguir:
1. **Em [Tutorial: criar e assinar um tópico do Amazon SNS](batch_sns_create_topic.md)**, use *BlockedJobQueue* como nome do tópico.
1. **Em [Tutorial: registrar uma regra de evento](batch_sns_reg_rule.md)**, use o seguinte padrão no editor JSON:
```
{
"detail-type": [
"Batch Job Queue Blocked"
],
"source": [
"aws.batch"
]
}
```