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á. # Criação de uma regra programada (legada) na Amazon EventBridge **nota** As regras programadas são um recurso antigo do EventBridge. EventBridgeoferece uma maneira mais flexível e poderosa de criar, executar e gerenciar tarefas agendadas centralmente, em grande escala: EventBridge Scheduler. Com o EventBridge Scheduler, você pode criar agendas 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. O Scheduler é altamente personalizável e oferece escalabilidade aprimorada em relação às regras programadas, com um conjunto mais amplo de operações e serviços de API de destino. AWS Recomendamos que você use o Agendador para invocar destinos em uma programação. Para obter mais informações, consulte [Criar uma programação](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) o *[Guia do usuário do EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)*. Em EventBridge, você pode criar dois tipos de regras programadas: + Regras que são executadas a uma taxa regular 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 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** EventBridge não fornece precisão de segundo nível em expressões de cronograma. A melhor resolução ao usar uma expressão cron é um minuto. Devido à natureza distribuída EventBridge e aos serviços de destino, pode haver um atraso de vários 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. ## Crie uma regra programada (antiga) As etapas a seguir explicam como criar uma EventBridge regra que seja executada regularmente. **nota** Só é possível criar regras programadas usando o barramento de eventos padrão. **Topics** + [Defina a regra](#eb-create-scheduled-rule-define) + [Defina a programação](#eb-create-scheduled-rule-schedule) + [Selecione destinos](#eb-create-scheduled-rule-target) + [Configurar tags e regra de revisão](#eb-create-scheduled-rule-review) ### 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 EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. No painel de navegação, em **Agendador**, escolha **Regra agendada (antiga)**. 1. Escolha **Criar regra programada**. 1. Informe um **Nome** para a regra e, opcionalmente, uma **Descrição** para a regra. Uma regra não pode ter o mesmo nome de outra regra no mesmo barramento de eventos Região da AWS e no mesmo. 1. Para que a regra entre em vigor assim que você a criar, verifique se a opção **Habilitar a regra agendada** está ativada. ### Defina a programação Em seguida, defina o padrão de programação. **Para definir o padrão de programação** + 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.** 1. Para a **expressão Cron**, especifique os campos para definir a expressão cron que EventBridge deve ser usada para determinar quando executar essa regra programada. Depois de especificar todos os campos, EventBridge exibe as próximas dez datas em EventBridge que 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 [Expressão cron](eb-scheduled-rule-pattern.md#eb-cron-expressions). ------ #### [ Regular rate ] 1. Escolha **Uma programação que seja executada em uma taxa regular, como a cada 10 minutos**. 1. Em **Expressão de taxa**, especifique os campos **Valor** e **Unidade** para definir a taxa na qual essa regra programada EventBridge deve ser executada. Para obter mais informações sobre como criar uma expressão rate, consulte [Expressões rate](eb-scheduled-rule-pattern.md#eb-rate-expressions). ------ ### Selecione destinos Escolha um ou mais destinos para receber eventos que correspondam ao padrão especificado. Os alvos podem incluir um barramento de EventBridge eventos, destinos de EventBridge API, 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 ônibus de EventBridge eventos, selecione **ônibus de EventBridge eventos** 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**. 1. 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 [Envio de eventos entre ônibus de eventos na mesma conta e região na Amazon EventBridge](eb-bus-to-bus.md). + Para usar um barramento de eventos em uma conta Região da AWS ou diferente, siga esta regra: 1. Selecione **Barramento de eventos em uma conta ou região diferente**. 1. 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 eventos entre AWS contas na Amazon EventBridge](eb-cross-account.md) + [Envio e recebimento de eventos entre AWS regiões na Amazon EventBridge](eb-cross-region.md) ------ #### [ API destination ] Para usar um destino de EventBridge API, selecione o **destino EventBridge da API** e, em seguida, 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 são **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 de API como alvos na Amazon EventBridge](eb-api-destinations.md). ------ #### [ AWS service (Serviço da AWS) ] Para usar um AWS service (Serviço da AWS)**AWS service (Serviço da AWS)**, selecione 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 de barramento de eventos disponíveis no EventBridge console](eb-targets.md#eb-console-targets). ------ 1. Para muitos tipos de destino, o EventBridge precisa de permissões para enviar eventos ao destino. Nesses casos, EventBridge você pode criar a função do IAM necessária para que sua regra seja 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**. 1. Insira um nome para essa função de execução ou use o nome gerado por EventBridge. + Para usar um perfil de execução existente para esta regra: 1. Selecione **Usar perfil existente**. 1. Insira ou selecione o nome do perfil de execução a ser usado na lista suspensa. 1. (Opcional) Para **Configurações adicionais**, especifique qualquer uma das configurações opcionais disponíveis para seu tipo de destino: ------ #### [ Event bus ] (Opcional) Para **fila de mensagens mortas, escolha se deseja usar uma fila** padrão do Amazon SQS como fila de mensagens mortas. EventBridge envia eventos que correspondam a essa regra para a fila de mensagens mortas se não forem entregues com sucesso ao destino. Faça um dos procedimentos a seguir: + Escolha **None** (Nenhum) para não usar uma fila de mensagens não entregues. + 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 **Selecionar uma fila do Amazon SQS em outra conta da AWS como uma fila de mensagens não entregues** e insira o ARN da fila a ser utilizada. Você deve anexar uma política baseada em recursos à fila que conceda EventBridge permissão para enviar mensagens para ela. Para obter mais informações, consulte [Como conceder permissões para a fila de mensagens não entregues](eb-rule-dlq.md#eb-dlq-perms). ------ #### [ 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** — EventBridge envia todo o evento de origem original para o destino. Esse é o padrão. + **Parte dos eventos correspondentes** — envia EventBridge 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 você deseja enviar EventBridge para o destino. + **Constante (texto JSON)** — 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 você deseja enviar EventBridge para o destino em vez do evento. + **Transformador de entrada** — Configure um transformador de entrada para personalizar o texto que você deseja EventBridge enviar ao alvo. Para obter mais informações, consulte [Transformação EventBridge de insumos da Amazon](eb-transform-target-input.md). 1. Selecione **Configurar transformador de entrada**. 1. Configure o transformador de entrada seguindo as etapas em [Configurando um transformador de entrada ao criar uma regra no EventBridge](eb-transform-input-rule.md). 1. (Opcional) Em **Política de repetição**, EventBridge especifique como 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) EventBridge para reter eventos não processados. O padrão é 24 horas. + **Tentativas de repetição** — insira o número máximo de vezes que EventBridge você deve tentar enviar novamente um evento para o destino após a ocorrência de um erro. O padrão é 185 vezes. 1. (Opcional) Para **fila de mensagens mortas, escolha se deseja usar uma fila** padrão do Amazon SQS como fila de mensagens mortas. EventBridge envia eventos que correspondam a essa regra para a fila de mensagens mortas se não forem entregues com sucesso ao destino. Faça um dos procedimentos a seguir: + Escolha **None** (Nenhum) para não usar uma fila de mensagens não entregues. + Escolha **Selecionar uma fila do Amazon SQS na AWS conta atual para usar como fila de mensagens mortas e, em seguida, selecione a fila** a ser usada na lista suspensa. + Escolha **Selecionar uma fila do Amazon SQS em outra conta da AWS como uma fila de mensagens não entregues** e insira o ARN da fila a ser utilizada. Você deve anexar uma política baseada em recursos à fila que conceda EventBridge permissão para enviar mensagens para ela. Para obter mais informações, consulte [Como conceder permissões para a fila de mensagens não entregues](eb-rule-dlq.md#eb-dlq-perms). ------ #### [ AWS service ] Observe que EventBridge talvez não exiba todos os campos a seguir para um determinado AWS serviço. 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** — EventBridge envia todo o evento de origem original para o destino. Esse é o padrão. + **Parte dos eventos correspondentes** — envia EventBridge 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 você deseja enviar EventBridge para o destino. + **Constante (texto JSON)** — 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 você deseja enviar EventBridge para o destino em vez do evento. + **Transformador de entrada** — Configure um transformador de entrada para personalizar o texto que você deseja EventBridge enviar ao alvo. Para obter mais informações, consulte [Transformação EventBridge de insumos da Amazon](eb-transform-target-input.md). 1. Selecione **Configurar transformador de entrada**. 1. Configure o transformador de entrada seguindo as etapas em [Configurando um transformador de entrada ao criar uma regra no EventBridge](eb-transform-input-rule.md). 1. (Opcional) Em **Política de repetição**, EventBridge especifique como 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) EventBridge para reter eventos não processados. O padrão é 24 horas. + **Tentativas de repetição** — insira o número máximo de vezes que EventBridge você deve tentar enviar novamente um evento para o destino após a ocorrência de um erro. O padrão é 185 vezes. 1. (Opcional) Para **fila de mensagens mortas, escolha se deseja usar uma fila** padrão do Amazon SQS como fila de mensagens mortas. EventBridge envia eventos que correspondam a essa regra para a fila de mensagens mortas se não forem entregues com sucesso ao destino. Faça um dos procedimentos a seguir: + Escolha **None** (Nenhum) para não usar uma fila de mensagens não entregues. + Escolha **Selecionar uma fila do Amazon SQS na AWS conta atual para usar como fila de mensagens mortas e, em seguida, selecione a fila** a ser usada na lista suspensa. + Escolha **Selecionar uma fila do Amazon SQS em outra conta da AWS como uma fila de mensagens não entregues** e insira o ARN da fila a ser utilizada. Você deve anexar uma política baseada em recursos à fila que conceda EventBridge permissão para enviar mensagens para ela. Para obter mais informações, consulte [Como conceder permissões para a fila de mensagens não entregues](eb-rule-dlq.md#eb-dlq-perms). ------ 1. (Opcional) Selecione **Adicionar outro destino** para adicionar outro destino a essa regra. 1. Escolha **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 [Recursos de marcação na Amazon EventBridge](eb-tagging.md). 1. Escolha **Próximo**. 1. 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**.