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
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:
-
Escolha os eventos que você deseja processar
-
Configurar a filtragem e o teste de eventos
-
Selecione e configure alvos
-
Definir as configurações da regra
Escolha os eventos
Primeiro, escolha os eventos que você deseja enviar para o alvo.
Para selecionar um evento
-
Abra o EventBridge console da Amazon em https://console.aws.amazon.com/events/
. -
No painel de navegação, escolha Regras e, em seguida, escolha Criar regra.
-
Na guia Eventos, encontre os eventos que você deseja enviar para o alvo:
-
Escolha Eventos AWS de serviço ou Eventos personalizados.
-
Use a caixa Pesquisar ou navegue pela lista de eventos para encontrar os eventos que você deseja enviar para o alvo.
-
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
-
Escolha a guia Árvore do painel Esquema.
-
Adicione e edite filtros para criar o padrão do evento.
Escolha o ícone de filtro ao lado do atributo que você deseja adicionar como filtro ao padrão do evento.
-
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.
Insira o valor que você deseja igualar.
Clique na marca de seleção para finalizar.
EventBridge adiciona o filtro que você criou ao JSON no painel Event pattern.
-
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)
-
Escolha um evento de amostra para teste ou use o seu próprio.
-
Use exemplos de eventos fornecidos
Escolha Usar exemplos de eventos fornecidos.
-
Em Exemplo de evento acionador, selecione o evento a ser usado para teste na lista suspensa.
-
Use seu próprio evento
-
Escolha Usar seu próprio evento.
EventBridge exibe um evento genérico com um
detailselemento vazio. -
Edite o JSON do evento para criar o evento em relação ao qual você deseja testar seu padrão de eventos.
dica
Você pode usar os eventos de amostra fornecidos como pontos de partida para criar seus próprios eventos personalizados para usar em seus testes:
-
Escolha Usar eventos de amostra fornecidos, escolha um evento do evento acionador de amostra e, em seguida, escolha Copiar.
-
Escolha Usar seu próprio evento.
-
Selecione o evento inteiro na janela e cole o evento de amostra sobre ele.
Edite o evento conforme desejado.
-
-
-
-
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
-
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.
-
Configure o alvo com base no seu tipo de alvo. Para obter etapas detalhadas de configuração, consulte EventBridge Targets.
Personalize os dados do evento enviados ao 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)
-
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.
-
Em Configuração de transformação de entrada, escolha Ativar.
-
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.
Configuração da regra do
Por fim, configure e crie a regra.
Para configurar a regra (console)
-
Selecione Configurar.
-
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.
-
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.
-
Para habilitar a regra assim que ela for criada, em Ativação, habilite Ativo.
-
(Opcional) Insira uma ou mais tags para a regra. Para obter mais informações, consulte Marcação de recursos com tags no Amazon EventBridge.
Escolha Criar.
Próximas etapas
Depois de criar sua regra, você pode:
Recursos adicionais do
Para obter mais informações sobre EventBridge regras, consulte: