Como criar uma regra do Amazon EventBridge que é executada de acordo com uma programação.

Uma regra pode ser executada em resposta a um evento ou em determinados intervalos de tempo. Por exemplo, para executar periodicamente uma função do AWS Lambda, é possível criar uma regra para ser executada de acordo com uma agenda.

nota

O EventBridge oferece o Agendador do Amazon EventBridge, um agendador com tecnologia sem servidor que permite criar, executar e gerenciar tarefas de um serviço gerenciado central. 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 de API de destino e serviços da AWS.

Recomendamos que você use o Agendador do EventBridge para invocar alvos em uma programação. Para obter mais informações, consulte Como usar o Agendador do Amazon EventBridge com o Amazon EventBridge.

No EventBridge, é possível criar dois tipos de regras programadas:

• Regras que são executadas a uma taxa regular

  O EventBridge executa essas regras em intervalos regulares; por exemplo, a cada 20 minutos.

  Para especificar a taxa de uma regra programada, você define uma expressão rate.

• Regras que são executadas em horários específicos

  O EventBridge executa essas regras em horários e datas específicos; por exemplo, 8:00 da manhã PST na primeira segunda-feira de cada mês.

  Para especificar a hora e as datas em que uma regra programada é executada, você define uma expressão cron.

As expressões rate são mais simples de definir, enquanto as expressões cron oferecem controle detalhado do cronograma. Por exemplo, com uma expressão cron, é possível definir uma regra que é executada em um horário especificado em um determinado dia de cada semana ou mês. Por outro lado, as expressões rate executam uma regra em uma frequência regular, como uma vez por hora ou uma vez por dia.

Todos os eventos programados usam o fuso horário UTC+0 e a precisão mínima para uma programação é de um minuto.

nota

O EventBridge não fornece precisão no segundo nível em expressões de programação. A melhor resolução ao usar uma expressão cron é um minuto. Por conta da natureza distribuída do EventBridge e aos serviços de destino, pode haver um atraso de diversos segundos entre o momento em que a regra programada é acionada e o momento em que o serviço de destino executa o recurso de destino.

O seguinte vídeo fornece uma visão geral das tarefas de programação:

Tópicos

• Criar uma regra que seja executada em uma programação
• Referência de expressões cron
• Referência de expressões rate

Criar uma regra que seja executada em uma programação

As etapas a seguir explicam como criar uma regra do EventBridge que seja executada regularmente.

nota

Só é possível criar regras programadas usando o barramento de eventos padrão.

Defina a regra

Primeiro, insira um nome e uma descrição para a regra para identificá-la.

Para definir os detalhes da regra

1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

2. No painel de navegação, escolha Rules (Regras).

3. Escolha Create rule (Criar regra).

4. Informe um Nome para a regra e, opcionalmente, uma Descrição para a regra.

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

5. Em Selecionar barramento de eventos, escolha o barramento de eventos padrão. Só é possível criar regras programadas usando o barramento de eventos padrão.

6. Para que a regra entre em vigor assim que você a criar, verifique se a opção Habilitar a regra no barramento de eventos selecionado está ativada.

7. Em Rule type (Tipo de regra), escolha Schedule (Programação).

   Neste momento, é possível continuar com a criação de uma regra que é executada de acordo com uma programação ou usar o Agendador do Amazon EventBridge.

8. Escolha como deseja continuar:

   • Use o EventBridge Scheduler para criar sua agenda

     nota

     O Agendador do EventBridge é um programador com tecnologia sem servidor que permite criar, executar e gerenciar tarefas de um serviço gerenciado central. Ele fornece uma funcionalidade de programação única e recorrente, independente das regras e barramentos de eventos. 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 de API de destino e serviços da AWS.

     Recomendamos que você use o Agendador do EventBridge para invocar alvos em uma programação. Para obter mais informações, consulte O que é o Agendador do Amazon EventBridge? no Manual do usuário do Agendador do Amazon EventBridge.

     1. Selecione Continuar no Agendador do EventBridge

        O EventBridge abre o console do Agendador do EventBridge na página Criar agendamento.

     2. Crie a programação no console do Agendador do EventBridge.

   • Continue usando o EventBridge para criar uma regra programada para o barramento de eventos padrão

     1. Selecione Continuar para criar a regra.

Defina a programação

Em seguida, defina o padrão de programação.

Para definir o padrão de programação

1. Em Padrão de programação, escolha se deseja que a programação seja executada em um horário específico ou em uma taxa normal:

   Specific time

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

   2. Para a expressão Cron, especifique os campos para definir a expressão cron que o EventBridge deve usar para determinar quando executar essa regra programada.

      Depois de especificar todos os campos, o EventBridge exibirá as próximas dez datas em que o EventBridge executará essa regra programada. Também é possível escolher se deseja exibir essas datas em UTC ou no Fuso horário local.

      Para obter mais informações sobre como criar uma expressão cron, consulte Referência de expressões cron.

   Regular rate

   1. Escolha Uma programação que seja executada em uma taxa regular, como a cada 10 minutos.

   2. Em Expressão rate, especifique os campos Valor e Unidade para definir a taxa na qual o EventBridge deve executar essa regra programada.

      Para obter mais informações sobre como criar uma expressão rate, consulte Referência de expressões rate.

2. Escolha Next (Próximo).

Selecione destinos

Escolha um ou mais destinos para receber eventos que correspondam ao padrão especificado. Os destinos podem incluir um barramento de eventos do EventBridge, destinos da API do EventBridge, incluindo parceiros de SaaS, como Salesforce, ou outros AWS service (Serviço da AWS).

Para selecionar destinos

1. Para Tipo de destino, escolha um dos seguintes tipos de destino:

   Event bus

   Para selecionar um barramento de eventos do EventBridge, selecione o Barramento de eventos do EventBridge e faça o seguinte:

   • Para usar um barramento de eventos da mesma forma Região da AWS que esta regra:

     1. Selecione Barramento de eventos na mesma conta e região.

     2. Em Barramento de eventos para destino, escolha a caixa suspensa e insira o nome do barramento de eventos. Também é possível selecionar o barramento de eventos na lista suspensa.

        Para obter mais informações, consulte Enviar e receber EventBridge eventos da Amazon entre ônibus de eventos na mesma conta e região.

   • Para usar um barramento de eventos em uma conta ou Região da AWS diferente como esta regra:

     1. Selecione Barramento de eventos em uma conta ou região diferente.

     2. Para Barramento de eventos como destino, insira o ARN do barramento de eventos que deseja usar.

        Para obter mais informações, consulte:

        • Enviar e receber EventBridge eventos da Amazon entre AWS contas

        • Envio e recebimento de EventBridge eventos da Amazon entre AWS regiões

   API destination

   Para usar um destino da API EventBridge, selecione o Destino da API do EventBridge e faça o seguinte:

   • Para usar um destino de API existente, selecione Usar um destino de API existente. Em seguida, selecione um destino de API na lista suspensa.

   • Para criar um novo destino de API, selecione Criar um novo destino de API. Em seguida, forneça os seguintes detalhes para o destino:

     • Nome: insira um nome para o destino.

       Os nomes devem ser exclusivos em sua Conta da AWS. Nomes podem ter até 64 caracteres. Os caracteres válidos A-Z, a-z, 0-9 e . _ - (hífen).

     • (Opcional) Descrição: insira uma descrição para o destino.

       As descrições podem ter até 512 caracteres.

     • Endpoint de destino da API: o endpoint de URL para o destino.

       O URL do endpoint deve começar com https. É possível incluir * como um parâmetro de caminho curinga. É possível definir parâmetros de caminho a partir do atributo HttpParameters do destino.

     • Método HTTP: selecione o método HTTP usado ao invocar o endpoint.

     • (Opcional) Limite de taxa de invocação por segundo: insira o número máximo de invocações aceitas por segundo para este destino.

       Este valor deve ser maior que zero. Por padrão, este valor é definido como 300.

     • Conexão: escolha usar uma conexão nova ou existente:

       • Para usar uma conexão existente, selecione Usar uma conexão existente e selecione a conexão na lista suspensa.

       • Para criar uma nova conexão para esse destino, selecione Criar uma nova conexão e defina o nome, o tipo de destino e o tipo de autorização da conexão. Também é possível adicionar uma descrição opcional para essa conexão.

   Para obter mais informações, consulte Destinos da API.

   AWS service (Serviço da AWS)

   Para usar um AWS service (Serviço da AWS), selecione AWS service (Serviço da AWS) e faça o seguinte:

   1. Em Selecionar um destino, selecione um AWS service (Serviço da AWS) para usar como destino. Forneça as informações solicitadas para o serviço selecionado.

      nota

      Os campos exibidos variam de acordo com o serviço selecionado. Para obter mais informações sobre os destinos disponíveis, consulte Alvos disponíveis no EventBridge console.

2. Para muitos tipos de destino, o Eventbridge precisa de permissões para enviar eventos ao destino. Nesses casos, o Eventbridge pode criar a função do IAM necessária para sua função ser executada.

   Em Perfil de execução, realize um dos seguintes procedimentos:

   • Para criar um novo perfil de execução para esta regra:

     1. Selecione Criar um novo perfil para este recurso específico.

     2. Insira um nome para este perfil de execução ou use o nome gerado pelo EventBridge.

   • Para usar um perfil de execução existente para esta regra:

     1. Selecione Usar perfil existente.

     2. Insira ou selecione o nome do perfil de execução a ser usado na lista suspensa.

3. (Opcional) Para Configurações adicionais, especifique qualquer uma das configurações opcionais disponíveis para seu tipo de destino:

   Event bus

   Em Fila de mensagens não entregues, escolha se será usada uma fila padrão do Amazon SQS como uma fila de mensagens não entregues. O EventBridge envia eventos que correspondem a essa regra para a fila de mensagens mortas se eles não forem entregues com êxito ao destino. Faça um dos seguintes procedimentos:

   • Escolha None (Nenhum) para não usar uma fila de mensagens mortas.

   • Escolha Selecionar uma fila do Amazon SQS na conta atual da AWS para usar como a fila de mensagens não entregues e depois selecione na lista suspensa a fila a ser usada.

   • Escolha Selecione uma fila do Amazon SQS em outra conta da AWS 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 que conceda permissão ao EventBridge para enviar mensagens a ela.

     Para obter mais informações, consulte Como conceder permissões para a fila de mensagens não entregues.

   API destination

   1. (Opcional) Em Configurar entrada de destino, escolha como deseja personalizar o texto enviado ao destino para eventos correspondentes. Escolha uma das seguintes opções:

      • Eventos correspondentes: o EventBridge envia todo o evento de origem original para o destino. Esse é o padrão.

      • Parte dos eventos correspondentes: o EventBridge envia apenas a parte especificada do evento de origem original para o destino.

        Em Especificar a parte do evento correspondente, especifique um caminho JSON que defina a parte do evento que deseja que o EventBridge envie para o destino.

      • Constante (texto JSON): o EventBridge envia somente o texto JSON especificado para o destino. Nenhuma parte do evento de origem original é enviada.

        Em Especificar a constante em JSON, especifique o texto JSON que deseja que o EventBridge envie para o destino em vez do evento.

      • Transformador de entrada: configure um transformador de entrada para personalizar o texto que deseja que o EventBridge envie para o destino. Para obter mais informações, consulte Transformação EventBridge de insumos da Amazon.

        1. Selecione Configurar transformador de entrada.

        2. Configure o transformador de entrada seguindo as etapas em Como configurar um transformador de entrada como parte da criação de uma regra.

   2. (Opcional) Em Política de repetição, especifique como o EventBridge deve tentar enviar novamente um evento para um destino após a ocorrência de um erro.

      • Idade máxima do evento: Insira o tempo máximo (em horas, minutos e segundos) para que o EventBridge retenha eventos não processados. O padrão é 24 horas.

      • Tentativas de repetição: insira o número máximo de vezes que o EventBridge deve tentar enviar novamente um evento para o destino após a ocorrência de um erro. O padrão é 185 vezes.

   3. Em Fila de mensagens não entregues, escolha se será usada uma fila padrão do Amazon SQS como uma fila de mensagens não entregues. O EventBridge envia eventos que correspondem a essa regra para a fila de mensagens mortas se eles não forem entregues com êxito ao destino. Faça um dos seguintes procedimentos:

      • Escolha None (Nenhum) para não usar uma fila de mensagens mortas.

      • Escolha Selecionar uma fila do Amazon SQS na conta atual da AWS para usar como a fila de mensagens não entregues e depois selecione na lista suspensa a fila a ser usada.

      • Escolha Selecione uma fila do Amazon SQS em outra conta da AWS 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 que conceda permissão ao EventBridge para enviar mensagens a ela.

        Para obter mais informações, consulte Como conceder permissões para a fila de mensagens não entregues.

   AWS service

   Observe que o EventBridge pode não exibir todos os campos a seguir para um determinado serviço da AWS.

   1. (Opcional) Em Configurar entrada de destino, escolha como deseja personalizar o texto enviado ao destino para eventos correspondentes. Escolha uma das seguintes opções:

      • Eventos correspondentes: o EventBridge envia todo o evento de origem original para o destino. Esse é o padrão.

      • Parte dos eventos correspondentes: o EventBridge envia apenas a parte especificada do evento de origem original para o destino.

        Em Especificar a parte do evento correspondente, especifique um caminho JSON que defina a parte do evento que deseja que o EventBridge envie para o destino.

      • Constante (texto JSON): o EventBridge envia somente o texto JSON especificado para o destino. Nenhuma parte do evento de origem original é enviada.

        Em Especificar a constante em JSON, especifique o texto JSON que deseja que o EventBridge envie para o destino em vez do evento.

      • Transformador de entrada: configure um transformador de entrada para personalizar o texto que deseja que o EventBridge envie para o destino. Para obter mais informações, consulte Transformação EventBridge de insumos da Amazon.

        1. Selecione Configurar transformador de entrada.

        2. Configure o transformador de entrada seguindo as etapas em Como configurar um transformador de entrada como parte da criação de uma regra.

   2. (Opcional) Em Política de repetição, especifique como o EventBridge deve tentar enviar novamente um evento para um destino após a ocorrência de um erro.

      • Idade máxima do evento: Insira o tempo máximo (em horas, minutos e segundos) para que o EventBridge retenha eventos não processados. O padrão é 24 horas.

      • Tentativas de repetição: insira o número máximo de vezes que o EventBridge deve tentar enviar novamente um evento para o destino após a ocorrência de um erro. O padrão é 185 vezes.

   3. Em Fila de mensagens não entregues, escolha se será usada uma fila padrão do Amazon SQS como uma fila de mensagens não entregues. O EventBridge envia eventos que correspondem a essa regra para a fila de mensagens mortas se eles não forem entregues com êxito ao destino. Faça um dos seguintes procedimentos:

      • Escolha None (Nenhum) para não usar uma fila de mensagens mortas.

      • Escolha Selecionar uma fila do Amazon SQS na conta atual da AWS para usar como a fila de mensagens não entregues e depois selecione na lista suspensa a fila a ser usada.

      • Escolha Selecione uma fila do Amazon SQS em outra conta da AWS 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 que conceda permissão ao EventBridge para enviar mensagens a ela.

        Para obter mais informações, consulte Como conceder permissões para a fila de mensagens não entregues.

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

5. Escolha Next (Próximo).

Configurar tags e regra de revisão

Por fim, insira as tags desejadas para a regra, revise e crie a regra.

Para configurar tags, revisar e criar a regra

1. (Opcional) Insira uma ou mais tags para a regra. Para obter mais informações, consulte EventBridge Etiquetas da Amazon.

2. Escolha Next (Próximo).

3. Analise os detalhes da nova regra. Para fazer mudanças a qualquer seção, escolha o botão Editar próximo à seção.

   Quando estiver satisfeito com os detalhes da regra, escolha Criar regra.