Como usar o Agendador do Amazon EventBridge com o Amazon EventBridge

O Agendador do Amazon EventBridge é um agendador sem servidor que permite criar, executar e gerenciar tarefas de um serviço gerenciado central. 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. É possível configurar janelas de tempo flexíveis para entrega, bem como definir limites de repetição e o tempo máximo de retenção para invocações de API com falha.

O Agendador do EventBridge é altamente personalizável e oferece escalabilidade aprimorada em relação às Regras programadas do EventBridge, com um conjunto mais amplo de operações da API de destino e serviços da AWS. Recomendamos que você use o Agendador do EventBridge para invocar alvos em uma programação.

Configurar o perfil de execução

Quando você cria uma nova programação, o Agendador EventBridge deve ter permissão para invocar sua operação de API de destino em seu nome. Você concede essas permissões ao Agendador EventBridge usando um perfil de execução. A política de permissão que você anexa ao perfil de execução da sua programação define as permissões necessárias. Essas permissões dependem da API de destino que você deseja que o Agendador EventBridge invoque.

Quando você usa o console do Agendador EventBridge para criar uma programação, como no procedimento a seguir, o Agendador EventBridge configura automaticamente um perfil de execução com base no destino selecionado. Se você quiser criar uma agenda usando um dos SDKs do Agendador EventBridge, a AWS CLI ou o AWS CloudFormation, você deve ter um perfil de execução existente que conceda as permissões que o Agendador EventBridge exige para invocar um alvo. Para obter mais informações sobre como configurar manualmente um perfil de execução para sua programação, consulte Setting up an execution role no Guia do usuário do Agendador EventBridge.

Criar uma programação

Criar uma programação usando o console

1. Abra o console do Agendador do Amazon EventBridge em https://console.aws.amazon.com/scheduler/home.

2. Na página Programações, escolha Criar uma programação.

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

   2. (Opcional) Em Descrição, insira uma descrição para a sua programação. Por exemplo, My first schedule.

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

      Você usa grupos de programação para adicionar tags a eles.

4. 1. Escolha suas opções de programação.

      Ocorrência	Fazer isso...
      Programação única Uma programação única invoca um destino somente uma vez na data e hora que você especificar.	Para Data e hora, faça o seguinte: Insira uma data válida no formato YYYY/MM/DD. Insira um carimbo de data e hora no formato 24 horas, hh:mm. Para Fuso horário, escolha o fuso horário.
      Programação recorrente Uma programação recorrente invoca uma meta em uma taxa que você especifica usando uma expressão cron ou expressão de taxa.	Em Tipo de cronograma, siga um destes procedimentos: Para usar uma expressão cron para definir o cronograma, escolha Cronograma baseado em cron e insira a expressão cron. Para usar uma expressão rate para definir o cronograma, escolha Cronograma com base em rate e insira a expressão rate. Para obter mais informações sobre expressões cron e rate, consulte Schedule types on EventBridge Scheduler no Guia do usuário do Agendador do Amazon EventBridge. Para Janela de tempo flexível, escolha Desativado para desativar a opção ou escolher uma das janelas de tempo predefinidas. Por exemplo, se você escolher 15 minutos e definir uma programação recorrente para invocar sua meta uma vez a cada hora, a programação será executada em até 15 minutos após o início de cada hora.

5. (Opcional) Se você escolher Programação recorrente na etapa anterior, na seção Período, faça o seguinte:

   1. Para Fuso horário, escolha um fuso horário.

   2. Para Data e hora de início, insira uma data válida no formato YYYY/MM/DD e, em seguida, especifique um carimbo de data e hora no formato 24 horas, hh:mm.

   3. 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 e hora no formato 24 horas, hh:mm.

6. Escolha Next (Próximo).

7. Na página Selecionar destino, escolha a operação de API da AWS que o Agendador do EventBridge invoca:

   1. Em API de destino, escolha Destinos modelados.

   2. Escolha Amazon EventBridge PutEvents.

   3. Em PutEvents, especifique o seguinte:

      • No barramento de eventos do EventBridge, escolha o barramento do evento no menu suspenso. Por exemplo, default.

        Também é possível criar um novo barramento de eventos no console do EventBridge escolhendo Criar novo barramento de eventos.

      • Em Tipo de detalhe, insira o tipo de detalhe dos eventos que deseja combinar. Por exemplo, Object Created.

      • Em Origem, insira o nome do serviço que é a origem dos eventos.

        Para eventos de serviço da AWS, especifique o prefixo do serviço como origem. Não inclua o prefixo aws.. Por exemplo, para eventos do Amazon S3, insira s3.

        Para determinar o prefixo de um serviço, consulte A tabela de chaves de condição na Referência de autorização de serviço. Para obter mais informações sobre valores de eventos de tipo de origem e detalhe, consulte Referência de estrutura de eventos.

      • (Opcional): Em Detalhe, insira um padrão de evento para filtrar ainda mais os eventos que o Agendador do EventBridge envia para o EventBridge.

        Para obter mais informações, consulte Padrões de EventBridge eventos da Amazon.

8. Escolha Next (Próximo).

9. Na página Settings (Configurações), faça o seguinte:

   1. Para ativar a programação, em Estado da programação, alterne para Ativar programação.

   2. Para configurar uma política de novas tentativas para a sua programação, em Política de novas tentativas e fila de mensagens não entregues (DLQ), faça o seguinte:

      • Alterne para Tentar novamente.

      • Para Idade máxima do evento, insira as horas e os minutos máximos que o Agendador do EventBridge deve manter um evento não processado.

      • O tempo máximo é de 24 horas.

      • Para Máximo de tentativas, insira o número máximo de vezes que o Agendador do EventBridge tentará novamente a programação se o destino retornar um erro.

        O valor máximo é 185 novas tentativas.

      Com políticas de novas tentativas, se uma programação falhar em invocar seu destino, o Agendador do EventBridge executará novamente a programação. Se configurado, você deve definir o tempo máximo de retenção e as novas tentativas para a programação.

   3. Escolha onde o Agendador do EventBridge armazena os eventos não entregues.

      Opção Filas de mensagens não entregues (DLQ)	Fazer isso...
      Não armazene	Selecione None.
      Armazenar o evento na mesma Conta da AWS em que você está criando a programação	Escolha Selecione uma fila do Amazon SQS na minha Conta da AWScomo uma DLQ. Escolha o nome do recurso da Amazon (ARN) da fila do Amazon SQS.
      Armazenar o evento em uma Conta da AWS diferente de onde você está criando a programação	Escolha Especifique uma fila do Amazon SQS em outras Contas da AWS como uma DLQ. Insira o nome do recurso da Amazon (ARN) da fila do Amazon SQS.

   4. Para usar uma chave gerenciada pelo cliente para criptografar sua entrada de destino, em Criptografia, escolha Personalizar as configurações de criptografia (avançado).

      Se você escolher essa opção, insira uma chave ARN do KMS existente ou escolha Criar um AWS KMS key para navegar até o console do AWS KMS. Para obter mais informações sobre como o Agendador do EventBridge criptografa seus dados em repouso, consulte Encryption at rest no Guia do usuário do Agendador do Amazon EventBridge.

   5. Para que o Agendador do EventBridge crie um novo perfil de execução para você, escolha Criar um novo perfil para esta programação. Depois, insira um nome para Nome do perfil. Se você escolher essa opção, o Agendador do EventBridge anexará as permissões necessárias para seu destino de exemplo ao perfil.

10. Escolha Next (Próximo).

11. Na página Revisar e criar uma programação, revise os detalhes da sua programação. Em cada seção, escolha Editar para voltar a essa etapa e editar seus detalhes.

12. Escolha Criar programação.

    Você pode ver uma lista das suas programações novas e existentes na página Programações. Na coluna Status, verifique se sua nova programação está Ativada.

Recursos relacionados

Para obter mais informações sobre o Agendador do EventBridge, consulte o seguinte:

• Guia do usuário do Agendador do EventBridge

• Referência da API do Agendador do EventBridge

• Preços do Agendador do EventBridge