

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á.

# Tutorial: criar uma regra com um padrão de evento
<a name="event-pattern-batch-job"></a>

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*.