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á.
# Regras na Amazon EventBridge
Você especifica o que EventBridge acontece com os eventos entregues em cada ônibus de eventos. Para fazer isso, você cria *regras*. Uma regra especifica quais eventos enviar para quais [destinos](eb-targets.md) para serem processados. Uma única regra pode enviar um evento para vários destinos, que são executados em paralelo.
Você pode criar dois tipos de regra: regras que correspondem aos dados do evento à medida que eles são entregues e regras que são executadas em uma programação definida. Além disso, determinados AWS serviços também podem criar e gerenciar regras em sua conta.
## Regras que correspondem aos dados do evento
Você pode criar regras que correspondam aos eventos recebidos com base nos critérios de dados do evento (chamados de *padrão de eventos*). Um padrão de evento define a estrutura do evento e os campos aos quais uma regra corresponde para iniciar a ação de destino. Se um evento corresponder aos critérios definidos no padrão do evento, ele será EventBridge enviado para o (s) alvo (s) especificado (s).
Para obter mais informações, consulte [Criação de regras na Amazon EventBridge](eb-create-rule-visual.md).
## Regras que são executadas de acordo com uma programação
**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)*.
Você também pode criar regras que enviem eventos aos destinos especificados em intervalos específicos. Por exemplo, para executar periodicamente uma Lambda função, você pode criar uma regra para ser executada de acordo com uma agenda.
Para obter mais informações, consulte [Criação de uma regra programada (legada) na Amazon EventBridge](eb-create-rule-schedule.md).
## Regras gerenciadas por AWS serviços
Além das regras que você cria, AWS os serviços podem criar e gerenciar EventBridge regras em sua AWS conta que são necessárias para determinadas funções nesses serviços. Elas são chamadas de *regras gerenciadas*.
Quando um serviço cria uma regra gerenciada, ele também pode criar uma [política do IAM](eb-iam.md) que conceda permissões a esse serviço para criar a regra. As políticas do IAM criadas desta forma têm um escopo limitado com permissões no nível do recurso para permitir a criação apenas das regras necessárias.
É possível excluir regras gerenciadas usando a opção **Forçar exclusão**, mas elas devem ser excluídas somente se você tiver certeza de que o outro serviço não precisará mais da regra. Do contrário, excluir uma regra gerenciada faz os recursos que dependem dela deixar de funcionar.
# Criação de regras na Amazon EventBridge
## Pré-requisitos
Antes de começar, verifique se você tem:
+ Acesso ao EventBridge console da Amazon
+ Permissões apropriadas do IAM para criar EventBridge regras
+ Compreensão básica de arquiteturas orientadas por eventos
## Visão geral do
Para agir em relação aos eventos recebidos por EventBridge, você pode criar regras. Quando um evento corresponde ao padrão de evento definido em sua regra, EventBridge envia o evento para o destino especificado.
Este tópico orienta você na criação de uma regra EventBridge usada para combinar eventos à medida que eles são enviados para o barramento de eventos especificado.
A criação de EventBridge regras envolve quatro etapas principais:
1. Escolha os eventos que você deseja processar
1. Configurar a filtragem e o teste de eventos
1. Selecione e configure alvos
1. Definir as configurações da regra
## Escolha os eventos
Primeiro, escolha os eventos que você deseja enviar para o alvo.
**Para selecionar um evento**
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, escolha **Regras** e, em seguida, escolha **Criar regra**.
1. Na guia **Eventos**, encontre os eventos que você deseja enviar para o alvo:
1. Escolha **Eventos AWS de serviço** ou **Eventos personalizados**.
1. Use a caixa Pesquisar ou navegue pela lista de eventos para encontrar os eventos que você deseja enviar para o alvo.
1. Arraste um ou mais eventos para a tela **Build** e solte-o em **Triggering** Events.
EventBridge exibe a seção **Eventos de Acionamento**. Esta seção inclui:
+ **Eventos**, que lista o evento que você escolheu.
+ **Esquema**, que exibe o esquema do evento selecionado, se disponível.
O **esquema** contém três guias:
+ **Árvore**: uma visualização em árvore do esquema do evento.
+ **Código**: o esquema do evento na especificação Open API ou no formato JSON.
+ **Informações**: informações gerais sobre o esquema.
+ **Evento de amostra**, que exibe uma amostra de um evento selecionado, se disponível.
+ **Padrão de evento (filtro)**, que contém um padrão de evento que seleciona todos os eventos que você escolheu.
## Filtre eventos para enviar somente o que você deseja
Você provavelmente não desejará enviar *todos os* eventos de um tipo específico para um alvo. Você pode tornar seu padrão de evento mais específico para que ele selecione apenas eventos que contenham os atributos e valores nos quais você está interessado.
### Edite o padrão do evento (opcional)
No painel **Acionando eventos**, você pode criar o padrão de eventos de duas maneiras:
+ Visualmente, usando a visualização em árvore **do esquema**
+ Editando diretamente o JSON no painel **Event pattern**
**Para editar o padrão do evento usando a visualização em árvore do esquema**
1. Escolha a guia **Árvore** do painel **Esquema**.
1. Adicione e edite filtros para criar o padrão do evento.
1. Escolha o ícone de filtro ao lado do atributo que você deseja adicionar como filtro ao padrão do evento.
1. Escolha um operador de comparação na lista suspensa.
Para obter mais informações sobre operadores de comparação, consulte [Criação de padrões de eventos](eb-create-pattern-operators.md).
1. Insira o valor que você deseja igualar.
1. Clique na marca de seleção para finalizar.
EventBridge adiciona o filtro que você criou ao JSON no painel **Event pattern**.
1. Adicione filtros adicionais até criar um padrão de evento que corresponda a todos os atributos de evento desejados.
### Teste o padrão do evento
Depois de criar um padrão de evento que corresponda a todos os atributos de evento desejados, teste para garantir que o padrão de evento funcione conforme o esperado.
#### Teste o padrão do evento (opcional)
1. Escolha um evento de amostra para teste ou use o seu próprio.
+ **Use exemplos de eventos fornecidos**
1. Escolha **Usar exemplos de eventos fornecidos**.
1. Em **Exemplo de evento acionador**, selecione o evento a ser usado para teste na lista suspensa.
+ **Use seu próprio evento**
1. Escolha **Usar seu próprio evento**.
EventBridge exibe um evento genérico com um `details` elemento vazio.
1. Edite o JSON do evento para criar o evento em relação ao qual você deseja testar seu padrão de eventos.
**dica**
É possível usar os eventos de exemplo fornecidos como ponto de partida para criar eventos personalizados para uso em testes:
Escolha **Usar os eventos de exemplo fornecidos**, selecione um evento em **Evento desencadeador de amostra** e escolha **Copiar**.
Escolha **Usar seu próprio evento**.
Selecione o evento inteiro na janela e cole o evento de exemplo sobre ele.
Edite o evento conforme desejado.
1. Escolha **Executar teste**.
EventBridge exibe uma mensagem informando se o evento de teste corresponde ao padrão do evento.
## Selecione destinos
Arraste um (e até cinco) alvos para a tela **Build** e solte-o em **Targets** para receber eventos que correspondam ao padrão de evento especificado. As metas podem incluir:
+ Outros ônibus para EventBridge eventos, no mesmo ou em outro Conta da AWS
+ EventBridge Destinos de API, incluindo parceiros de SaaS, como Salesforce
+ Uma variedade de recursos de AWS serviços, como filas do Amazon SQS ou tópicos do Amazon SNS
**Para selecionar destinos**
1. Selecione o tipo de **alvo** no painel Targets e solte-o na forma **Targets** na tela Build.
EventBridge exibe a seção **Destino** na Construção, com as opções de configuração aplicáveis com base no tipo de alvo selecionado.
**dica**
Se você tiver especificado mais de um alvo, selecionar a forma do alvo exibirá a seção de configuração desse alvo.
1. Configure o alvo com base no seu tipo de alvo. Para obter etapas detalhadas de configuração, consulte [EventBridge Targets](eb-targets.md).
### Personalize os dados do evento enviados para o alvo
Se você selecionar um destino que não seja um barramento de EventBridge eventos ou um destino de EventBridge API, você tem a opção de personalizar quais dados realmente são entregues ao destino.
#### Transformar ou substituir os dados do evento enviados (opcional)
1. Na tela de design do Build, escolha o ícone **Transformação de entrada** na forma **Alvos**.
EventBridge exibe a seção **Transformação de entrada**.
1. Em **Configuração de transformação de entrada**, escolha **Ativar**.
1. Selecione o método de transformação para escolher como você deseja personalizar o texto enviado ao destino para eventos correspondentes:
+ **Parte dos eventos correspondentes** — envia EventBridge apenas a parte especificada do evento de origem original para o destino.
+ **Constante (texto JSON)** — EventBridge envia somente o texto JSON especificado para o destino. Nenhuma parte do evento de origem original é enviada.
+ **Transformador de entrada** — Configure um transformador de entrada para personalizar o texto que você EventBridge deseja enviar ao alvo. Para obter mais informações, consulte [Transformação da entrada de destino](eb-transform-target-input.md).
## Configuração da regra do
Por fim, configure e crie a regra.
**Para configurar a regra (console)**
1. Selecione **Configurar**.
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. Em **Barramento de eventos**, selecione o barramento de eventos para associar com essa regra.
Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, escolha **Barramento de eventos padrão da AWS **. Quando um AWS service (Serviço da AWS) em sua conta envia um evento, ele sempre vai para o ônibus de eventos padrão da sua conta.
1. Para habilitar a regra assim que ela for criada, em **Ativação**, habilite **Ativo**.
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 **Criar**.
## Próximas etapas
Depois de criar sua regra, você pode:
+ [Monitore o desempenho das regras usando métricas](eb-monitoring.md)
+ [Teste sua regra com exemplos de eventos](eb-event-pattern-sandbox.md)
+ [Modifique os padrões de eventos conforme necessário](eb-event-patterns.md)
+ [Adicione metas adicionais às regras existentes](eb-targets.md)
## Recursos adicionais do
Para obter mais informações sobre EventBridge regras, consulte:
+ [EventBridge visão geral das regras](eb-rules.md)
+ [Criação de padrões de eventos](eb-event-patterns.md)
+ [EventBridge alvos](eb-targets.md)
+ [ EventBridge Regras de solução de problemas](eb-troubleshooting.md)
# Criação de regras que reagem a eventos na Amazon EventBridge
Para agir em relação aos eventos recebidos pela Amazon EventBridge, você pode criar [regras](eb-rules.md). Quando um evento corresponde ao [padrão de evento](eb-event-patterns.md) definido em sua regra, EventBridge envia o evento para o [destino](eb-targets.md) especificado e aciona a ação definida na regra.
As etapas a seguir explicam como criar uma regra EventBridge usada para combinar eventos à medida que eles são enviados para o barramento de eventos especificado.
**Topics**
+ [Defina a regra](#eb-create-rule-define)
+ [Criar o padrão de eventos](#eb-create-rule-event-pattern)
+ [Selecione destinos](#eb-create-rule-target)
+ [Configurar tags e regra de revisão](#eb-create-rule-review)
## Defina a regra
Primeiro, insira um nome e uma descrição para a regra para identificá-la. Também é preciso definir o barramento de eventos em que sua regra procura eventos que correspondam a um padrão de eventos.
**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, escolha **Regras**.
1. Escolha **Create rule**.
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. Em **Barramento de eventos**, selecione o barramento de eventos para associar com essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, escolha **Barramento de eventos padrão da AWS **. 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.
1. Em **Rule type**, escolha **Rule with an event pattern**.
1. Escolha **Próximo**.
## Criar o padrão de eventos
Em seguida, crie o padrão do evento. Para fazer isso, especifique a origem do evento, escolha a base para o padrão do evento e defina os atributos e valores aos quais corresponder. Também é possível gerar o padrão de evento em JSON e testá-lo em um evento de amostra.
**Para criar o padrão de eventos**
1. Em **Origem do evento**, escolha **AWS eventos ou eventos de EventBridge parceiros**.
1. (Opcional) Na seção **Eventos de amostra**, escolha um **Tipo de evento de amostra** com o qual deseja testar seu padrão de evento.
Os seguintes tipos de eventos estão disponíveis:
+ **AWS eventos** — Selecione entre os eventos emitidos pelo suporte Serviços da AWS.
+ **EventBridge eventos de parceiros** — selecione entre os eventos emitidos por serviços terceirizados que oferecem suporte EventBridge, como o Salesforce.
+ **Inserir o meu próprio**: insira o seu próprio evento em texto JSON.
Você também pode usar um evento AWS ou um evento de um parceiro como ponto de partida para criar seu próprio evento personalizado.
1. Selecione **AWS eventos ou eventos** de **EventBridge parceiros**.
1. Use o menu suspenso **Exemplos de eventos** para selecionar o evento que deseja usar como ponto de partida para seu evento personalizado.
EventBridge exibe o evento de amostra.
1. Selecione **Copiar**.
1. Selecione **Inserir meu próprio** para o **Tipo de evento**.
1. Exclua a estrutura de eventos de amostra no painel de edição JSON e cole o evento AWS ou o evento do parceiro em seu lugar.
1. Edite o JSON do evento para criar seu próprio evento de amostra.
1. Escolha um **Método de criação**. Você pode criar um padrão de evento a partir de um EventBridge esquema ou modelo, ou pode criar um padrão de evento personalizado.
------
#### [ Existing schema ]
Para usar um EventBridge esquema existente para criar o padrão de evento, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, selecione **Usar esquema**.
1. Na seção **Padrão de evento**, em **Tipo de esquema**, selecione **Selecionar esquema do registro do esquema**.
1. Em **Registro do esquema**, escolha a caixa suspensa e insira o nome de um registro do esquema, como `aws.events`. Também é possível selecionar uma opção na lista suspensa que aparece.
1. Em **Esquema**, escolha a caixa suspensa e insira o nome do esquema a ser usado. Por exemplo, .`aws.s3@ObjectDeleted` Também é possível selecionar uma opção na lista suspensa que aparece.
1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.
1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
EventBridge exibe uma caixa de mensagem informando se o evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
#### [ Custom schema ]
Para escrever um esquema personalizado e convertê-lo em um padrão de evento, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, escolha **Usar esquema**.
1. Na seção **Padrão de evento**, em **Tipo de esquema**, escolha **Inserir esquema**.
1. Insira o seu esquema na caixa de texto. É preciso formatar o esquema como texto JSON válido.
1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.
1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
EventBridge exibe uma caixa de mensagem informando se o evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
#### [ Event pattern ]
Para escrever um padrão de evento personalizado no formato JSON, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, escolha **Padrão personalizado (editor JSON)**.
1. Em **Padrão de evento**, insira seu padrão de evento personalizado em texto formatado em JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
EventBridge exibe uma caixa de mensagem informando se o evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
+ **Formulário de padrão de evento**: abre o padrão de evento no Criador de padrões. Se o padrão não puder ser renderizado no Pattern Builder no estado em que se encontra, EventBridge avisa você antes de abrir o Pattern Builder.
------
1. Escolha **Próximo**.
## 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 ]
1. Selecione o **ônibus EventBridge do evento**.
1. Escolha o barramento de eventos a ser usado como o destino.
+ 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:
+ [Envio e recebimento de 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)
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:
(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 eles 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. Selecione o **destino EventBridge da API**.
1. Escolha um destino de API novo ou existente:
+ 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 **.** **\$1** **-** (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 **\$1** 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.
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:
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 eles 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).
Para obter mais informações, consulte [Destinos de API como alvos na Amazon EventBridge](eb-api-destinations.md).
------
#### [ AWS service (Serviço da AWS) ]
1. Selecione **AWS service (Serviço da AWS)**.
1. Em **Selecionar um destino**, selecione um AWS service (Serviço da AWS) para usar como destino.
1. Se você escolher um AWS serviço que ofereça suporte a metas entre contas, poderá selecionar uma meta na mesma conta do barramento de eventos ou em uma conta diferente.
+ Para um destino na mesma conta, para **Tipo de destino**, selecione **Destino nesta conta**.
1. 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.
+ Para um alvo em uma conta diferente, em **Tipo de destino**, selecione **Alvo em outra AWS conta**.
1. Insira o ARN do recurso de destino para o qual você deseja enviar eventos.
1. Forneça todas as informações adicionais solicitadas para o serviço selecionado.
1. Selecione o nome da função de execução a ser usada na lista suspensa.
1. (Opcional) Para **Configurações adicionais**, especifique qualquer uma das configurações opcionais disponíveis para seu tipo de destino:
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 eles 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**.
# Desativando ou excluindo uma regra na Amazon EventBridge
Para impedir que uma [regra](eb-rules.md) processe [eventos](eb-events.md) ou seja executada de acordo com uma agenda, é possível excluir ou desativar a regra. As etapas a seguir explicam como excluir ou desativar uma EventBridge regra.
**Para excluir uma desativar uma 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, escolha **Regras**.
Em **Event bus (Barramento de eventos)**, selecione o barramento de eventos associado à regra.
1. Execute um destes procedimentos:
1. Para excluir uma regra, selecione o botão próximo à regra e escolha **Ações**, **Excluir**, **Excluir**.
Se a regra for uma regra gerenciada, insira o nome da regra para confirmar que se trata de uma regra gerenciada e que a exclusão pode interromper a funcionalidade no serviço que criou a regra. Para continuar, insira o nome da regra e selecione **Force delete (Forçar exclusão)**.
1. Para desabilitar temporariamente uma regra, selecione o botão ao lado da regra e escolha **Disable (Desabilitar)**, **Disable (Desabilitar)**.
Não é possível desabilitar uma regra gerenciada.
# Melhores práticas ao definir regras na Amazon EventBridge
Abaixo estão algumas das práticas recomendadas a serem consideradas ao criar regras para seus barramentos de eventos.
## Defina um único destino para cada regra
Embora você possa especificar até cinco destinos para uma determinada regra, o gerenciamento de regras é mais fácil quando você especifica um único destino para cada regra. Se mais de um destino precisar receber o mesmo conjunto de eventos, recomendamos duplicar a regra para entregar os mesmos eventos a destino diferentes. Este encapsulamento simplifica a manutenção das regras: se as necessidades dos destinos do evento divergirem com o tempo, você poderá atualizar cada regra e seu padrão de evento independentemente das outras.
## Configurar permissões de regras
É possível permitir que componentes ou serviços de aplicações que consomem eventos tenham o controle do gerenciamento de suas próprias regras. Uma abordagem arquitetônica comum adotada pelos clientes é isolar esses componentes ou serviços do aplicativo usando AWS contas separadas. Para habilitar o fluxo de eventos de uma conta para outra, é preciso criar uma regra em um barramento de eventos que encaminhe eventos para um barramento de eventos em outra conta. É possível permitir que equipes ou serviços de aplicações que consomem eventos tenham o controle do gerenciamento de suas próprias regras. Isso é feito ao especificar as permissões adequadas para as contas por meio de políticas de recursos. Isto funciona em todas as contas e regiões.
Para obter mais informações, consulte [Permissões para ônibus de eventos na Amazon EventBridge](eb-event-bus-perms.md).
Por exemplo de políticas de recursos, consulte [Padrões de design de várias contas com a Amazon EventBridge ativada](https://github.com/aws-samples/amazon-eventbridge-resource-policy-samples/tree/main/patterns) GitHub.
## Melhor desempenho de regras
Monitore suas regras para garantir que elas estejam funcionando conforme o esperado:
+ Monitorar a métrica `TriggeredRules` em busca de pontos de dados ausentes ou anomalias pode ajudá-lo a detectar discrepâncias em um publicador que fez uma alteração significativa. Para obter mais informações, consulte [Monitorando a Amazon EventBridge](eb-monitoring.md).
+ O alarme sobre anomalias ou a contagem máxima esperada também pode ajudar a detectar quando uma regra está correspondendo a novos eventos. Isto pode acontecer quando publicadores de eventos, incluindo serviços da AWS e parceiros de SaaS, introduzem novos eventos ao habilitar novos casos de uso e atributos. Quando esses novos eventos são inesperados e levam a um volume maior do que a taxa de processamento do destino downstream, podem resultar em um acúmulo de eventos.
Este processamento de eventos inesperados também pode levar a cobranças de cobrança indesejadas.
Também pode acionar a limitação de regras quando a conta ultrapassa sua cota de serviço alvo agregada de invocações por segundo. EventBridge ainda tentará entregar eventos compatíveis com regras limitadas e tentar novamente por até 24 horas ou conforme descrito na política de repetição personalizada do alvo. É possível detectar e alarmar regras limitadas usando a métrica `ThrottledRules`
+ Para casos de uso de baixa latência, também é possível monitorar o uso da latência usando `IngestionToInvocationStartLatency`, que fornece uma indicação da integridade do seu barramento de eventos. Qualquer período prolongado de alta latência acima de 30 segundos pode indicar uma interrupção do serviço ou controle de utilização de regras.
# Usando AWS Serverless Application Model modelos para implantar EventBridge recursos da Amazon
Você pode criar e testar [regras](eb-rules.md) manualmente no EventBridge console, o que pode ajudar no processo de desenvolvimento à medida que você refina [os padrões de eventos](eb-event-patterns.md). No entanto, quando estiver tudo pronto para implantar sua aplicação, será mais fácil usar uma estrutura como a de [AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html) para lançar todos os seus recursos com tecnologia sem servidor de forma consistente.
Usaremos esse [aplicativo de exemplo](https://github.com/aws-samples/amazon-eventbridge-producer-consumer-example) para analisar as maneiras pelas quais você pode usar AWS SAM modelos para criar EventBridge recursos. O arquivo template.yaml neste exemplo é um AWS SAM modelo que define quatro [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)funções e mostra duas maneiras diferentes de integrar as funções Lambda com. EventBridge
Para obter uma explicação passo a passo dessa aplicação de exemplo, consulte [Tutorial: criar uma aplicação de exemplo do Amazon EventBridge](eb-tutorial-get-started.md).
Existem duas abordagens de uso EventBridge e AWS SAM modelos. Para integrações simples em que uma função do Lambda é invocada por uma regra, a abordagem de **Modelo combinado** é recomendada. Se você tem uma lógica de roteamento complexa ou está se conectando a recursos fora do seu AWS SAM modelo, a abordagem de **modelo separado** é a melhor escolha.
**Topics**
+ [Modelo combinado](#eb-combined-template)
+ [Modelo separado](#eb-separated-template)
## Modelo combinado
A primeira abordagem usa a `Events` propriedade para configurar a EventBridge regra. O código de exemplo a seguir define um [evento](eb-events.md) que invoca sua função do Lambda.
**nota**
Este exemplo cria automaticamente a regra no [barramento de eventos](eb-event-bus.md) padrão, que existe em todas as AWS contas. Para associar a regra a um barramento de eventos personalizado, você pode adicionar o `EventBusName` ao modelo.
```
atmConsumerCase3Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case3Handler
Runtime: nodejs12.x
Events:
Trigger:
Type: CloudWatchEvent
Properties:
Pattern:
source:
- custom.myATMapp
detail-type:
- transaction
detail:
result:
- "anything-but": "approved"
```
Esse código YAML é equivalente a um padrão de evento no EventBridge console. No YAML, você só precisa definir o padrão do evento e criar AWS SAM automaticamente uma função do IAM com as permissões necessárias.
## Modelo separado
Na segunda abordagem para definir uma EventBridge configuração em AWS SAM, os recursos são separados mais claramente no modelo.
1. Primeiro, defina a função do Lambda:
```
atmConsumerCase1Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case1Handler
Runtime: nodejs12.x
```
1. Em seguida, defina a regra usando um recurso da `AWS::Events::Rule`. As propriedades definem o padrão do evento e também podem especificar [destinos](eb-targets.md). É possível definir explicitamente vários destinos.
```
EventRuleCase1:
Type: AWS::Events::Rule
Properties:
Description: "Approved transactions"
EventPattern:
source:
- "custom.myATMapp"
detail-type:
- transaction
detail:
result:
- "approved"
State: "ENABLED"
Targets:
-
Arn:
Fn::GetAtt:
- "atmConsumerCase1Fn"
- "Arn"
Id: "atmConsumerTarget1"
```
1. Por fim, defina um `AWS::Lambda::Permission` recurso que conceda permissão EventBridge para invocar o alvo.
```
PermissionForEventsToInvokeLambda:
Type: AWS::Lambda::Permission
Properties:
FunctionName:
Ref: "atmConsumerCase1Fn"
Action: "lambda:InvokeFunction"
Principal: "events.amazonaws.com"
SourceArn:
Fn::GetAtt:
- "EventRuleCase1"
- "Arn"
```
# Gerando um AWS CloudFormation modelo a partir de uma EventBridge regra existente
AWS CloudFormation permite que você configure e gerencie seus AWS recursos em contas e regiões de forma centralizada e repetível, tratando a infraestrutura como código. CloudFormation faz isso permitindo que você crie *modelos*, que definem os recursos que você deseja provisionar e gerenciar.
EventBridge permite que você gere modelos a partir das regras existentes em sua conta, como uma ajuda para ajudá-lo a começar a desenvolver CloudFormation modelos. É possível selecionar uma única regra ou várias regras para incluir no modelo. Em seguida, você pode usar esses modelos como base para [criar pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) de recursos sob CloudFormation gerenciamento.
Para obter mais informações, CloudFormation consulte [*o Guia CloudFormation do usuário*.](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
**nota**
EventBridge não inclui [regras gerenciadas](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) no modelo gerado.
Também é possível [gerar um modelo de barramento de eventos existente](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-generate-event-bus-template.html), incluindo as regras contidas no barramento de eventos.
**Para gerar um CloudFormation modelo a partir de uma ou mais regras**
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, escolha **Regras**.
1. Em **Selecionar barramento de eventos**, escolha o barramento de eventos que contém as regras que deseja incluir no modelo.
1. Em **Regras**, escolha as regras que você deseja incluir no CloudFormation modelo gerado.
Para uma única regra, também é possível escolher o nome da regra para exibir a página de detalhes da regra.
1. Escolha **CloudFormation Modelo** e, em seguida, escolha em qual formato você EventBridge deseja gerar o modelo: **JSON** ou **YAML**.
EventBridge exibe o modelo, gerado no formato selecionado.
1. EventBridge oferece a opção de baixar o arquivo de modelo ou copiar o modelo para a área de transferência.
+ Para baixar o arquivo de modelo, escolha **Baixar**.
+ Para copiar o modelo para a área de transferência, escolha **Copiar**.
1. Para sair do modelo, escolha **Cancelar**.
Depois de personalizar seu CloudFormation modelo conforme necessário para seu caso de uso, você pode usá-lo para [criar pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) CloudFormation.
## Considerações ao usar CloudFormation modelos gerados pela Amazon EventBridge
Considere os seguintes fatores ao usar um CloudFormation modelo que você gerou a partir de EventBridge:
+ EventBridge não inclui nenhuma senha no modelo gerado.
É possível editar o modelo para incluir [parâmetros de modelo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) que permitam aos usuários especificar senhas ou outras informações confidenciais ao usar o modelo para criar ou atualizar uma pilha do CloudFormation.
Além disso, os usuários podem usar o Secrets Manager para criar um segredo na região desejada e depois editar o modelo gerado para empregar [parâmetros dinâmicos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager).
+ Os destinos no modelo gerado permanecem exatamente como foram especificados no barramento de eventos original. Isso poderá resultar em problemas entre regiões se você não editar adequadamente o modelo antes de utilizá-lo para criar pilhas em outras regiões.
Além disso, o modelo gerado não cria os destinos downstream automaticamente.