Testar um padrão de eventos usando o sandbox do EventBridge Sandbox - Amazon EventBridge

Testar um padrão de eventos usando o sandbox do EventBridge Sandbox

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, ao usar o Sandbox no EventBridge, é possível 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, o EventBridge oferece 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 eventos do Amazon EventBridge.

Importante

No EventBridge, é possível criar regras que possam resultar em cobranças e controle de utilização mais altos do que o esperado. 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 para regras e Práticas recomendadas.

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

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

  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:

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

  5. 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. 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. 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. 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 avisará antes de abrir o Criador do Padrão.

  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.

    O EventBridge leva você para a etapa 1 de Criar regra, que pode ser usada 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 Criar regras que reagem a eventos no Amazon EventBridge.