Testando um padrão de evento usando o EventBridge Sandbox

As regras usam padrões de evento para selecionar eventos e enviá-los para os destinos. Os padrões de eventos têm a mesma estrutura que os eventos aos quais correspondem. Um padrão de evento corresponde a um evento ou não corresponde.

Definir um padrão de evento normalmente faz parte do processo maior de criar uma nova regra ou da edição de uma existente. No entanto EventBridge, usando o Sandbox in, você pode definir rapidamente um padrão de evento e usar um evento de amostra para confirmar se o padrão corresponde aos eventos desejados, sem precisar criar ou editar uma regra. Depois de testar seu padrão de evento, você EventBridge tem a opção de criar uma nova regra usando esse padrão de evento diretamente da sandbox.

Para obter mais informações sobre padrões de eventos, consulte Padrões de EventBridge eventos da Amazon.

Importante

Em EventBridge, é possível criar regras que podem gerar higher-than-expected cobranças e estrangulamentos. Por exemplo, é possível criar, por engano, uma regra que leva a um loop infinito, em que uma regra é acionada recursivamente sem fim. Supõe-se que uma regra possa detectar que as ACLs foram alteradas em um bucket do Amazon S3 e acionar o software para alterá-las para o estado desejado. Se a regra não for gravada cuidadosamente, a alteração subsequente às ACLs disparará a regra novamente, criando um loop infinito.

Para obter orientação sobre como escrever regras precisas e padrões de eventos para minimizar esses resultados inesperados, consulte Práticas recomendadas ao definir regras do Amazon EventBridge e Melhores práticas ao definir padrões de EventBridge eventos da Amazon.

Para testar um padrão de evento usando a EventBridge sandbox

1. Abra o EventBridge console da Amazon em https://console.aws.amazon.com/events/.

2. No painel de navegação, escolha Recursos do desenvolvedor, depois selecione Sandbox e, na página do Sandbox, escolha a guia Padrão do evento.

3. Em Origem do evento, escolha AWS eventos ou eventos de EventBridge parceiros.

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

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

     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 AWS ou o evento do parceiro em seu lugar.

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

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

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

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

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

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

6. (Opcional) Para criar uma regra com esse padrão de evento e atribuir a regra a um barramento de eventos específico, escolha Criar regra com padrão.

   EventBridge leva você para a Etapa 1 de Criar regra, que você pode usar para criar uma regra e atribuí-la ao barramento de eventos de sua escolha.

   Observe que a etapa 2: criar padrão de evento contém as informações do padrão de evento já especificadas e que pode aceitar ou atualizar.

   Para obter mais informações sobre como criar regras, consulte Como criar regras do Amazon EventBridge que reagem a eventos.