Como configurar um transformador de entrada como parte da criação de uma regra

Para criar um transformador de entrada de destino como parte de uma regra

1. Siga as etapas para criar uma regra, conforme detalhado em Como criar regras do Amazon EventBridge que reagem a eventos.

2. Na Etapa 3: selecione os destinos, expanda Configurações adicionais.

3. Em Configurar entrada de destino, escolha Transformador de entrada na lista suspensa.

   Clique em Configurar transformador de entrada.

   EventBridge exibe a caixa de diálogo Configurar transformador de entrada.

4. Na seção Evento de amostra, escolha um Tipo de evento de amostra com o qual deseja testar seu padrão de evento. Você pode escolher um AWS evento, 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 AWS evento desejado. Os eventos são organizados por AWS serviço.

      Quando você seleciona um evento, EventBridge preenche o evento de amostra.

      Por exemplo, se você escolher S3 Object Created, EventBridge exibirá um exemplo do evento S3 Object Created.

   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 emitidos por serviços terceirizados que oferecem suporte EventBridge, como o Salesforce.

   1. Selecione eventos de EventBridge parceiros.

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

      Quando você seleciona um evento, 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. EventBridge preenche o evento de amostra com um modelo de atributos de evento necessá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.

5. (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 é EventBridge enviada para o destino

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

6. 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, você pode referenciar essas variáveis no modelo de entrada para incluir dados do evento de origem original no evento transformado que 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 você tenha escolhido o AWS evento S3 Object Created 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.

7. Na seção Modelo, componha o modelo que você deseja usar para determinar o que EventBridge passa para o alvo.

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

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

   EventBridge processa o evento de amostra com base no modelo de entrada e exibe a saída transformada gerada em Saída. Essas são as informações que EventBridge passarão 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 "example-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.

9. Selecione Confirmar.

10. Siga o restante das etapas para criar uma regra, conforme detalhado em Como criar regras do Amazon EventBridge que reagem a eventos.