Criar regras que reagem a eventos no Amazon EventBridge - Amazon EventBridge
Defina a regraCriar o padrão de eventosSelecione destinosConfigurar tags e regra de revisão

Criar regras que reagem a eventos no Amazon EventBridge

Para tomar medidas em relação a eventos recebidos pelo Amazon EventBridge, você pode criar regras. Quando um evento corresponde o padrão do evento definido na sua regra, o EventBridge envia o evento para o destino especificado e aciona a ação definida na regra.

O seguinte vídeo explora a criação de diferentes tipos de regras e como testá-las:

As etapas a seguir explicam como criar uma regra que o EventBridge usa para combinar eventos à medida que eles são enviados para o barramento de eventos especificado.

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 console do Amazon EventBridge em https://console.aws.amazon.com/events/.

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

  3. Escolha 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 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) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.

  6. Em Tipo de Regra, escolha Regra com Padrão de Evento.

  7. 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 Event source, escolha Eventos da AWS ou eventos de parceiro do EventBridge.

  2. (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:

    • Eventos da AWS: selecione entre os eventos emitidos pelos Serviços da AWS compatíveis.

    • Eventos de parceiros do EventBridge: selecione entre os eventos emitidos por serviços de terceiros que são compatíveis com o EventBridge, como o Salesforce.

    • Inserir o meu próprio: insira o seu próprio evento em texto JSON.

      Também é possível usar um evento da AWS ou um evento de um parceiro como ponto de partida para criar seu próprio evento personalizado.

      1. Selecione Eventos da AWS ou Eventos de parceiros do EventBridge.

      2. Use o menu suspenso Exemplos de eventos para selecionar o evento que deseja usar como ponto de partida para seu evento personalizado.

        O EventBridge exibe o evento de amostra.

      3. Selecione Copiar.

      4. Selecione Inserir meu próprio para o Tipo de evento.

      5. Exclua a estrutura de eventos de amostra no painel de edição JSON e cole o evento da AWS ou do parceiro no lugar.

      6. Edite o JSON do evento para criar seu próprio evento de amostra.

  3. Escolha um Método de criação. Também é possível criar um padrão de evento a partir de um esquema ou modelo do EventBridge ou criar um padrão de evento personalizado.

    Existing schema

    Para usar um esquema do EventBridge 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.

    2. Na seção Padrão de evento, em Tipo de esquema, selecione Selecionar esquema do registro do esquema.

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

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

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

    6. Escolha Gerar padrão de evento em JSON para gerar e validar seu padrão de evento como texto JSON.

    7. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha Padrão de teste.

      O EventBridge exibe uma caixa de mensagem informando se seu 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.

    2. Na seção Padrão de evento, em Tipo de esquema, escolha Inserir esquema.

    3. Insira o seu esquema na caixa de texto. É preciso formatar o esquema como texto JSON válido.

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

    5. Escolha Gerar padrão de evento em JSON para gerar e validar seu padrão de evento como texto JSON.

    6. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha Padrão de teste.

      O EventBridge exibe uma caixa de mensagem informando se seu 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).

    2. Em Padrão de evento, insira seu padrão de evento personalizado em texto formatado em JSON.

    3. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha Padrão de teste.

      O EventBridge exibe uma caixa de mensagem informando se seu 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 Criador do Padrão no estado em que se encontra, o EventBridge avisa antes de abrir o Criador do Padrão.

  4. Escolha 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:

    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 ter mais informações, consulte Destinos de API como alvos no Amazon EventBridge.

    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 Destinos de barramento de eventos disponíveis no console do EventBridge.

  2. Para muitos tipos de destino, o Eventbridge precisa de permissões para enviar eventos ao destino. Nesses casos, o Eventbridge pode criar o perfil do IAM necessário para o perfil ser executado.

    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 enviará eventos que correspondam a essa regra para a fila de mensagens não entregues caso não sejam entregues com êxito 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. Anexe uma política baseada em recurso à fila responsável que conceda ao EventBridge permissão para enviar mensagens.

      Para ter 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 ter mais informações, consulte Transformação de entrada do Amazon EventBridge.

        1. Selecione Configurar transformador de entrada.

        2. Configure o transformador de entrada seguindo as etapas em Configurar um transformador de entrada ao criar uma regra no EventBridge.

    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 enviará eventos que correspondam a essa regra para a fila de mensagens não entregues caso não sejam entregues com êxito 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. Anexe uma política baseada em recurso à fila responsável que conceda ao EventBridge permissão para enviar mensagens.

        Para ter 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 ter mais informações, consulte Transformação de entrada do Amazon EventBridge.

        1. Selecione Configurar transformador de entrada.

        2. Configure o transformador de entrada seguindo as etapas em Configurar um transformador de entrada ao criar uma regra no EventBridge.

    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 enviará eventos que correspondam a essa regra para a fila de mensagens não entregues caso não sejam entregues com êxito 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. Anexe uma política baseada em recurso à fila responsável que conceda ao EventBridge permissão para enviar mensagens.

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

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

  5. Escolha Next (Próximo).

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

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 ter mais informações, consulte Marcação de recursos com tags no Amazon EventBridge.

  2. Escolha 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.