Testando padrões de eventos usando o EventBridge Sandbox - Amazon EventBridge

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

Testando padrões de eventos usando o 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 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. Suponha que você ACLs tenha criado uma regra para detectar as alterações em um bucket do Amazon S3 e acionar o software para alterá-las para o estado desejado. Se a regra não for escrita com cuidado, a alteração subsequente na ACLs acionará 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 Melhores práticas para regras e Práticas recomendadas.

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.

    • Insira o meu — Insira seu próprio evento em JSON texto.

      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 do evento de amostra no painel JSON de edição e cole o evento AWS ou o evento do parceiro em seu lugar.

      6. Edite o evento JSON 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 JSON texto.

    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.

      • Prettify — Facilita a leitura do JSON texto 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. Você deve formatar o esquema como JSON texto 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 JSON texto.

    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.

      • Prettify — Facilita a leitura do JSON texto adicionando quebras de linha, tabulações e espaços.

    Event pattern

    Para escrever um padrão de evento personalizado no JSON formato, faça o seguinte:

    1. Na seção Método de criação, em Método, escolha Padrão personalizado (JSONeditor).

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

    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.

      • Prettify — Facilita a leitura do JSON texto 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 Criação de regras que reagem a eventos na Amazon EventBridge.