Como testar um transformador de entrada de destino usando o EventBridge Sandbox - Amazon EventBridge

Como testar um transformador de entrada de destino usando o EventBridge Sandbox

É possível personalizar o texto de um evento antes que o EventBridge passe as informações para o destino de uma regra.

A configuração de um transformador de entrada normalmente faz parte de um processo maior de especificar um destino ao criar uma nova regra ou editar uma existente. Ao usar o Sandbox no EventBridge, no entanto, é possível configurar rapidamente um transformador de entrada e usar um evento de amostra para confirmar que está obtendo a saída desejada, sem precisar criar ou editar uma regra.

Para obter mais informações sobre a transformação de entrada, consulte Transformação de entrada do Amazon EventBridge.

Para testar um transformador de entrada de destino

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

  2. Em Recursos do desenvolvedor, escolha Sandbox e, na página Sandbox, escolha a guia Transformador de entrada de destino.

  3. Na seção Evento de amostra, escolha um Tipo de evento de amostra com o qual deseja testar seu padrão de evento. Também é possível escolher um evento da AWS , um evento de parceiro ou inserir seu próprio evento personalizado.

    AWS events

    Selecione entre os eventos emitidos pelos Serviços da AWS compatíveis.

    1. Selecione Eventos da AWS.

    2. Em Eventos de amostra, escolha o evento da AWS desejado. Os eventos são organizados pelo serviço da AWS.

      Ao selecionar um evento, o EventBridge preenche o evento de amostra.

      Por exemplo, se você escolher Objeto do S3 criado, o EventBridge exibirá um exemplo de evento do objeto do S3 criado.

    3. (Opcional) Também é possível selecionar Copiar para copiar o evento de amostra para a área de transferência do seu dispositivo.

    Partner events

    Selecione entre os eventos por serviços de terceiros que são compatíveis com o EventBridge, como o Salesforce.

    1. Selecione Eventos de parceiros do EventBridge.

    2. Em Exemplos de eventos, escolha o evento do parceiro desejado. Os eventos são organizados pelo parceiro.

      Ao selecionar um evento, o EventBridge preenche o evento de amostra.

    3. (Opcional) Também é possível selecionar Copiar para copiar o evento de amostra para a área de transferência do seu dispositivo.

    Enter your own

    Insira o seu próprio evento em texto JSON.

    1. Selecione Inserir seu próprio.

    2. O EventBridge preenche o evento de amostra com um modelo de atributos de evento obrigatórios.

    3. Edite e adicione ao evento de amostra conforme desejado. O evento de amostra deve ser JSON válido.

    4. (Opcional) Também é possível escolher uma das seguintes opções:

      • Copiar: copie o evento de amostra 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.

  4. (Opcional) Expanda a seção Exemplos de caminhos de entrada, modelos e saídas para ver exemplos de:

    • Como os caminhos JSON são usados para definir variáveis que representam dados de eventos

    • Como essas variáveis podem ser usadas em um modelo de transformador de entrada

    • A saída resultante que o EventBridge envia para o destino

    Para obter exemplos mais detalhados de transformações de entrada, consulte Exemplos de transformação de entrada.

  5. Na seção Transformador de entrada de destino, defina as variáveis que deseja usar no modelo de entrada.

    Variáveis usam caminho JSON para fazer referência a valores na origem do evento original. Em seguida, é possível referenciar essas variáveis no modelo de entrada para incluir dados do evento de origem original no evento transformado que o EventBridge passa para o destino. É possível definir até 100 variáveis. O transformador de entrada deve ser um JSON válido.

    Por exemplo, suponha que tenha escolhido o evento da AWS Objeto do S3 criado como seu evento de amostra para esse transformador de entrada. É possível definir as seguintes variáveis para uso em seu modelo:

    {
  "requester": "$.detail.requester",
  "key": "$.detail.object.key",
  "bucket": "$.detail.bucket.name"
}

    (Opcional) Também é possível escolher Copiar para copiar o transformador de entrada para a área de transferência do seu dispositivo.

  6. Na seção Modelo, componha o modelo que deseja usar para determinar o que o EventBridge passa para o destino.

    É possível usar JSON, strings, informações estáticas, variáveis que você definiu, bem como variáveis reservadas. Para obter exemplos mais detalhados de transformações de entrada, consulte Exemplos de transformação de entrada.

    Por exemplo, suponha que tenha definido as variáveis no exemplo anterior. O modelo a seguir poderia ser composto, que faz referência a essas variáveis, bem como às variáveis reservadas e às informações estáticas.

    {
    "message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
    "RuleName": <aws.events.rule-name>,
    "ruleArn" : <aws.events.rule-arn>,
    "Transformed": "Yes"
}

    (Opcional) Também é possível escolher Copiar para copiar o modelo para a área de transferência do seu dispositivo.

  7. Para testar seu modelo, selecione Gerar saída.

    O EventBridge processa o evento de amostra com base no modelo de entrada e exibe a saída transformada gerada em Saída. Estas são as informações que o EventBridge passará para o destino no lugar do evento de origem original.

    A saída gerada para o modelo de entrada de exemplo descrito acima seria a seguinte:

    {
    "message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
    "RuleName": rule-name,
    "ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
    "Transformed": "Yes"
}

    (Opcional) Também é possível escolher Copiar para copiar a saída gerada para a área de transferência do seu dispositivo.