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á.
# Usar o Agendador do Amazon EventBridge para iniciar a execução de uma máquina de estado do Step Functions
O [Agendador do Amazon EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html) utiliza a tecnologia sem servidor que permite criar, executar e gerenciar tarefas a partir de um serviço central gerenciado. Com o Agendador do EventBridge, você pode criar programações usando expressões cron e rate para padrões recorrentes ou configurar invocações únicas. Você pode configurar janelas de tempo flexíveis para entregas, definir limites de novas tentativas e o tempo máximo de retenção de invocações de API com falha.
Por exemplo, com o EventBridge Scheduler, você pode iniciar a execução de uma máquina de estado de acordo com uma programação quando ocorrer um evento relacionado à segurança ou para automatizar uma tarefa de processamento de dados.
Esta página explica como usar o Agendador do EventBridge para iniciar a execução de uma máquina de estado do Step Functions em uma programação.
**Topics**
+ [Configurar o perfil de execução](#using-eventbridge-scheduler-execution-role)
+ [Criar uma programação](#using-eventbridge-scheduler-create)
+ [Recursos relacionados](#using-eventbridge-scheduler-related-resources)
## Configurar o perfil de execução
Quando você cria uma programação, o Agendador do EventBridge deve ter permissão para invocar a operação da API de destino em seu nome. Você concede essas permissões ao Agendador do EventBridge usando um *perfil de execução*. A política de permissão que você anexa ao perfil de execução da programação define as permissões necessárias. As permissões dependem da API de destino que você deseja que o Agendador do EventBridge invoque.
Quando você usa o console do Agendador do EventBridge para criar programações, como no procedimento a seguir, o Agendador do EventBridge configura automaticamente um perfil de execução com base no destino selecionado. Se você quiser criar uma programação usando um dos SDKs do Agendador do EventBridge, a AWS CLI ou o CloudFormation, você deve ter um perfil de execução que conceda as permissões que o Agendador do EventBridge precisa para invocar o destino. Para obter mais informações sobre como configurar manualmente um perfil de execução para programações, consulte [Como configurar um perfil de execução](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html#setting-up-execution-role) no *Guia do usuário do Agendador do EventBridge*.
## Criar uma programação
**Para criar uma programação usando o console**
1. Abra o console do Agendador do Amazon EventBridge em [https://console.aws.amazon.com/scheduler/home](https://console.aws.amazon.com/scheduler/home/).
1. Na página **Programações**, clique em **Criar programação**.
1. Na página **Especificar detalhes da programação**, na seção **Nome e descrição da programação**, faça o seguinte:
1. Em **Nome da programação**, insira um nome para a programação. Por exemplo, **MyTestSchedule**.
1. (Opcional) Em **Descrição**, insira a descrição da programação. Por exemplo, **My first schedule**.
1. Em **Grupo de programação**, escolha um grupo de programação na lista suspensa. Se você não tiver um grupo, escolha **padrão**. Para criar um grupo de programação, escolha **criar sua própria programação**.
Para adicionar tags a grupos de programação, você usa os grupos de programação.
1.
1. Escolha as opções de programação.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/step-functions/latest/dg/using-eventbridge-scheduler.html)
1. (Opcional) Se você escolher **Programação recorrente** na etapa anterior, na seção **Período**, faça o seguinte:
1. Em **Fuso horário**, escolha um fuso horário.
1. Em **Data e hora de início**, insira uma data válida no formato `YYYY/MM/DD` e, em seguida, especifique um carimbo de data/hora no formato de 24 horas `hh:mm`.
1. Para **Data e hora de término**, insira uma data válida no formato `YYYY/MM/DD` e, em seguida, especifique um carimbo de data/hora no formato 24 horas `hh:mm`.
1. Escolha **Próximo**.
1. Na página **Selecionar destino**, escolha a operação de API da AWS que o Agendador do EventBridge invoca:
1. Clique em **AWS Step FunctionsStartExecution**.
1. Na seção **StartExecution**, selecione uma máquina de estado ou clique em **Criar máquina de estado**.
No momento, não é possível executar fluxos de trabalho expressos síncronos em uma programação.
1. Insira uma carga útil JSON para a execução. Mesmo que a máquina de estado não exija nenhuma carga útil JSON, você ainda deve incluir a entrada no formato JSON, conforme mostrado no exemplo a seguir.
```
{
"Comment": "sampleJSONData"
}
```
1. Escolha **Próximo**.
1. Na página **Configurações**, faça o seguinte:
1. Para ativar a programação, em **Estado da programação**, mude para **Ativar programação**.
1. Para configurar uma política de novas tentativas para a programação, em **Política de novas tentativas e fila de mensagens não entregues (DLQ)**, faça o seguinte:
+ Mude para **Tentar novamente**.
+ Em **Duração máxima do evento**, insira o período máximo de **horas** e **minutos** que o Agendador do EventBridge deve manter um evento não processado.
+ O período máximo é de 24 horas.
+ Em **Máximo de tentativas**, insira o número máximo de vezes que o Agendador do EventBridge tentará executar a programação se o destino retornar um erro.
O valor máximo é 185 tentativas.
Com as políticas de novas tentativas, se a programação não conseguir invocar o destino, o Agendador do EventBridge tentará executar novamente a programação. Se configurado, você deve definir o tempo máximo de retenção e as novas tentativas da programação.
1. Escolha onde o Agendador do EventBridge armazena os eventos não entregues.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/step-functions/latest/dg/using-eventbridge-scheduler.html)
1. Para usar uma chave gerenciada pelo cliente para criptografar a entrada de destino, em **Criptografia**, escolha **Personalizar as configurações de criptografia (avançado)**.
Se você escolher essa opção, insira o ARN da chave do KMS existente ou escolha **Criar AWS KMS key** para navegar até o console do AWS KMS. Para obter mais informações sobre como o Agendador do EventBridge criptografa os dados em repouso, consulte [Criptografia em repouso](https://docs.aws.amazon.com/scheduler/latest/UserGuide/encryption-rest.html) no *Guia do usuário do Agendador do Amazon EventBridge*.
1. Para que o Agendador do EventBridge crie um novo perfil de execução para você, escolha **Criar novo perfil para esta programação**. Depois, insira um nome em **Nome do perfil**. Se você escolher essa opção, o Agendador do EventBridge anexará as permissões necessárias para o destino de exemplo ao perfil.
1. Escolha **Próximo**.
1. Na página **Revisar e criar programação**, revise os detalhes da programação. Em cada seção, escolha **Editar** para voltar a essa etapa e editar seus detalhes.
1. Clique em **Criar programação**.
Você pode ver a lista com as programações novas e existentes na página **Programações**. Na coluna **Status**, verifique se a nova programação está **Ativada**.
Para confirmar que o Agendador do EventBridge invocou a função, verifique os [Amazon CloudWatch Logs da máquina de estado](cw-logs.md).
## Recursos relacionados
Para obter mais informações sobre o Agendador do EventBridge, consulte:
+ [Guia do usuário do Agendador do EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)
+ [Referência da API do Agendador do EventBridge](https://docs.aws.amazon.com/scheduler/latest/APIReference/Welcome.html)
+ [Preços do Agendador do EventBridge](https://aws.amazon.com/eventbridge/pricing/#Scheduler)