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 EventBridge console da Amazon em https://console.aws.amazon.com/events/.

2. Na barra de navegação, selecione o Região da AWS a ser usado.

3. No painel de navegação, escolha Regras.

4. Escolha Criar Regra.

5. 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 (_).

   nota

   Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos.

6. (Opcional) Em Description, insira uma descrição para a regra.

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

8. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente.

9. Em Rule type, escolha Rule with an event pattern.

10. Escolha Próximo.

11. Em Origem do evento, escolha AWS eventos ou eventos de EventBridge parceiros.

12. (Opcional) Para evento de amostra:

    1. Em Tipo de evento de amostra, escolha AWS eventos.

    2. Em Eventos de amostra, escolha Batch Job State Change.

13. Em Creation method, escolha Use pattern form.

14. Para padrão de eventos:

    1. Em Event source, escolha Serviços da AWS.

    2. Em AWS service (Serviço da AWS), escolha Batch.

    3. Em Event type, escolha Batch Job State Change.

15. Escolha Next (Próximo).

16. Em Target types (Tipos de destino), escolha AWS service (Serviço da AWS).

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

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

18. 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 um perfil do IAM que você criou antes, escolha Use existing role.

19. (Opcional) Expanda Additional settings.

    1. Em Configure target input, escolha como o texto de um evento é processado.

    2. Em Idade máxima do evento, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos.

    3. Em Tentativas de repetição, insira o número de vezes que um evento é repetido.

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

20. (Opcional) Selecione Add another target (Adicionar outro destino) para adicionar outro destino a essa regra.

21. Escolha Next (Próximo).

22. (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 no Guia EventBridge do usuário da Amazon.

23. Escolha Next (Próximo).

24. 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 a criação de regras, consulte Criação de EventBridge regras da Amazon que reagem a eventos no Guia EventBridge do usuário da Amazon.