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 regras na Amazon EventBridge
<a name="eb-create-rule-visual"></a>

## Pré-requisitos
<a name="eb-create-rule-prerequisites"></a>

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
<a name="eb-create-rule-overview"></a>

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
<a name="eb-create-rule-source"></a>

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
<a name="eb-create-rule-event-pattern-visual"></a>

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)
<a name="eb-create-rule-event-pattern-steps"></a>

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
<a name="eb-create-rule-event-pattern-test"></a>

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)
<a name="eb-create-rule-event-pattern-test-steps"></a>

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
<a name="eb-create-rule-target-visual"></a>

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
<a name="eb-create-rule-target-transform"></a>

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)
<a name="eb-create-rule-target-transform-steps"></a>

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
<a name="eb-create-rule-configure"></a>

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
<a name="eb-create-rule-next-steps"></a>

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
<a name="eb-create-rule-additional-resources"></a>

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)