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á. # Transformação EventBridge de insumos da Amazon Você pode personalizar o texto de um [evento](eb-events.md) antes de EventBridge passar as informações para o [destino](eb-targets.md) de uma [regra](eb-rules.md). Ao usar o transformador de entrada no console ou na API, são definidas variáveis que usam o caminho JSON para referenciar valores na origem original do evento. O evento transformado é enviado para um destino em vez do evento original. No entanto, os [parâmetros do caminho dinâmico](eb-targets.md#dynamic-path-parameters) devem fazer referência ao evento original, não ao evento transformado. É possível definir até 100 variáveis, atribuindo a cada um valor da entrada. Em seguida, você pode usar essas variáveis no *modelo de entrada* como < *variable-name* >. Para obter um tutorial sobre como usar o transformador de entrada, consulte [Tutorial: usar transformadores de entrada para transformar eventos no EventBridge](eb-input-transformer-tutorial.md). **nota** EventBridge não suporta toda a sintaxe do JSON Path e a avalia em tempo de execução. A sintaxe compatível inclui: notação de pontos (por exemplo, `$.detail`) traços sublinhados caracteres alfanuméricos índices de matriz curingas (\$1) barras dianteiras **Topics** + [Variáveis predefinidas](#eb-transform-input-predefined) + [Exemplos de transformação de entrada](#eb-transform-input-examples) + [Transformando a entrada usando a API EventBridge](#eb-transform-input-api) + [Transformando a entrada usando AWS CloudFormation](#eb-transform-input-cfn) + [Problemas comuns com a transformação de entrada](#eb-transform-input-issues) + [Configurando um transformador de entrada ao criar uma regra no EventBridge](eb-transform-input-rule.md) + [Testando um transformador de entrada de destino usando o Sandbox EventBridge](eb-sandbox-input-trans.md) ## Variáveis predefinidas Há variáveis predefinidas que podem ser usadas sem definir um caminho JSON. Estas variáveis são reservadas e não é possível criar variáveis com esses nomes: + ****`aws.events.rule-arn`— O Amazon Resource Name (ARN) da EventBridge regra. + ****`aws.events.rule-name`— O nome da EventBridge regra. + ****`aws.events.event.ingestion-time`— A hora em que o evento foi recebido por EventBridge. Este é um carimbo de data/hora ISO 8601. Essa variável é gerada por EventBridge e não pode ser substituída. + ****`aws.events.event`: a carga útil do evento original como JSON (sem o campo `detail`). Só pode ser usado como um valor para um campo JSON, pois o conteúdo não tem escape. + ****`aws.events.event.json`: a carga útil completa do evento original como JSON (com o campo `detail`). Só pode ser usado como um valor para um campo JSON, pois o conteúdo não tem escape. ## Exemplos de transformação de entrada Veja a seguir um exemplo de evento do Amazon EC2. ``` { "version": "0", "id": "7bf73129-1428-4cd3-a780-95db273d1602", "detail-type": "EC2 Instance State-change Notification", "source": "aws.ec2", "account": "123456789012", "time": "2015-11-11T21:29:54Z", "region": "us-east-1", "resources": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1111" ], "detail": { "instance-id": "i-0123456789", "state": "RUNNING" } } ``` Ao definir uma regra no console, selecione a opção **Input Transformer (Transformador de entrada)** em **Configure input (Configurar entrada)**. Essa opção exibe duas caixas de texto: uma para o *Input Path (Caminho de Entrada)* e outra para o *Input Template (Modelo de entrada)*. ### Caminho de entrada O *Caminho de entrada* é usado para definir variáveis. Use o caminho JSON para fazer referência a itens em seu evento e armazenar esses valores em variáveis. Por exemplo, é possível criar um *caminho de entrada* para fazer referência a valores no evento de exemplo inserindo o seguinte na primeira caixa de texto: Também é possível usar colchetes e índices para obter itens de matrizes. **nota** EventBridge substitui os transformadores de entrada em tempo de execução para garantir uma saída JSON válida. Por isso, coloque aspas nas variáveis que se referem aos parâmetros de caminho JSON, mas não coloque aspas nas variáveis que se referem a objetos ou matrizes JSON. ``` { "timestamp" : "$.time", "instance" : "$.detail.instance-id", "state" : "$.detail.state", "resource" : "$.resources[0]" } ``` Isto definirá duas variáveis, ``, ``, `` e ``. É possível pode fazer referência a essas variáveis ao criar o *modelo de entrada*. **nota** Os destinos Amazon CloudWatch Logs e SSM não suportam o uso de `Input` e `InputPath` em seus transformadores de entrada. ### Modelo de entrada O *modelo de entrada* é um modelo para as informações que você deseja passar para seu destino. É possível criar um modelo que transmita uma string ou JSON para o destino. Usando o evento anterior e o *caminho de entrada*, os exemplos de *modelo de entrada* a seguir transformarão o evento na saída de exemplo antes de fazer o roteamento dele para um destino. | Description | Modelo | Output | | --- | --- | --- | | String simples | 
"instance  is in "
| 
"instance i-0123456789 is in RUNNING"
| | **String com aspas de escape** | 
"instance \"\" is in "
| 
"instance \"i-0123456789\" is in RUNNING"
Observe que esse é o comportamento no EventBridge console. A AWS CLI faz o escape dos caracteres de barra e o resultado é `"instance "i-0123456789" is in RUNNING"`. | | **JSON simples** | 
{
  "instance" : ,
  "state": 
}
| 
{
  "instance" : "i-0123456789",
  "state": "RUNNING"
}
| | **JSON com strings e variáveis** | 
{
 "instance" : ,
 "state": "",
 "instanceStatus": "instance \"\" is in "
}
| 
{
 "instance" : "i-0123456789",
 "state": "RUNNING",
 "instanceStatus": "instance \"i-0123456789\" is in RUNNING"
}
| | **JSON com uma mistura de variáveis e informações estáticas** | 
{
  "instance" : ,
  "state": [ 9, , true ],
  "Transformed" : "Yes"
}
| 
{
  "instance" : "i-0123456789",
  "state": [
    9,
    "RUNNING",
    true
  ],
  "Transformed" : "Yes"
}
| | **Incluir variáveis reservadas no JSON** | 
{
  "instance" : ,
  "state": ,
  "ruleArn" : ,
  "ruleName" : ,
  "originalEvent" : 
}
| 
{
  "instance" : "i-0123456789",
  "state": "RUNNING",
  "ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
  "ruleName" : "example",
  "originalEvent" : {
    ... // commented for brevity
  }
}
| | **Incluir variáveis reservadas em uma string** | 
" triggered"
| 
"example triggered"
| | **Grupo de CloudWatch registros da Amazon** | 
{
  "timestamp" : ,
  "message": "instance \"\" is in "
}
| 
{
  "timestamp" : 2015-11-11T21:29:54Z,
  "message": "instance "i-0123456789" is in RUNNING
}
| ## Transformando a entrada usando a API EventBridge Para obter informações sobre como usar a EventBridge API para transformar a entrada, consulte [Usar o Input Transformer para extrair dados de um evento e inserir esses dados no destino](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2). ## Transformando a entrada usando AWS CloudFormation Para obter informações sobre como usar AWS CloudFormation para transformar a entrada, consulte [AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html). ## Problemas comuns com a transformação de entrada Esses são alguns problemas comuns ao transformar a entrada em: EventBridge + Para strings, as aspas são necessárias. + Não há validação ao criar o caminho JSON para o modelo. + Se especificar uma variável para corresponder a um caminho JSON que não existe no evento, essa variável não será criada e não aparecerá na saída. + Propriedades JSON, como `aws.events.event.json`, só podem ser usadas como o valor de um campo JSON, não embutidas em outras strings. + EventBridge não escapa dos valores extraídos pelo *caminho de entrada*, ao preencher o *modelo de entrada de* um destino. + Se um caminho JSON fizer referência a um objeto ou matriz JSON, mas a variável for referenciada em uma string, EventBridge removerá todas as aspas internas para garantir uma string válida. Por exemplo, para uma variável `` apontada`$.detail`, “Detalhe é” resultaria na EventBridge remoção de aspas do objeto. Portanto, se quiser gerar um objeto JSON com base em uma única variável de caminho JSON, deverá colocá-lo como uma chave. Neste exemplo, `{"detail": }`. + As aspas não são necessárias para variáveis que representam cadeias de caracteres. Elas são permitidas, mas adicionam EventBridge automaticamente aspas aos valores das variáveis de string durante a transformação, para garantir que a saída da transformação seja um JSON válido. EventBridge não adiciona aspas às variáveis que representam objetos ou matrizes JSON. Não adicione aspas para variáveis que representem objetos ou matrizes JSON. Por exemplo, o seguinte modelo de entrada inclui variáveis que representam cadeias de caracteres e objetos JSON: ``` { "ruleArn" : , "ruleName" : , "originalEvent" : } ``` Resultando em JSON válido com cotação adequada: ``` { "ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example", "ruleName" : "example", "originalEvent" : { ... // commented for brevity } } ``` + Para saída de texto (não JSON) como strings de várias linhas, coloque cada linha separada em seu modelo de entrada entre aspas duplas. Por exemplo, se estiver fazendo a correspondência de eventos de [descoberta do Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) com o seguinte padrão de eventos: ``` { "detail": { "severity": ["HIGH"], "status": ["ACTIVE"] }, "detail-type": ["Inspector2 Finding"], "source": ["inspector2"] } ``` E usando o seguinte caminho de entrada: ``` { "account": "$.detail.awsAccountId", "ami": "$.detail.resources[0].details.awsEc2Instance.imageId", "arn": "$.detail.findingArn", "description": "$.detail.description", "instance": "$.detail.resources[0].id", "platform": "$.detail.resources[0].details.awsEc2Instance.platform", "region": "$.detail.resources[0].region", "severity": "$.detail.severity", "time": "$.time", "title": "$.detail.title", "type": "$.detail.type" } ``` Você pode usar o modelo de entrada abaixo para gerar uma saída de string de várias linhas: ``` " severity finding " "Description: <description>" "ARN: \"<arn>\"" "Type: <type>" "AWS Account: <account>" "Region: <region>" "EC2 Instance: <instance>" "Platform: <platform>" "AMI: <ami>" ``` # Configurando um transformador de entrada ao criar uma regra no EventBridge <a name="eb-transform-input-rule"></a> Como parte da criação de uma regra, você pode especificar um transformador de entrada EventBridge para usar no processamento de eventos correspondentes antes de enviar esses eventos para o destino especificado. Você pode configurar transformadores de entrada para destinos que sejam AWS serviços ou destinos de API. **Para criar um transformador de entrada de destino como parte de uma regra** 1. Siga as etapas para criar uma regra, conforme detalhado em [Criação de regras na Amazon EventBridge](eb-create-rule-visual.md). 1. Na **Etapa 3: selecione os destinos**, expanda **Configurações adicionais**. 1. 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**. 1. 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 **. 1. 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. 1. (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**. 1. 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. 1. (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**. 1. EventBridge preenche o evento de amostra com um modelo de atributos de evento necessários. 1. Edite e adicione ao evento de amostra conforme desejado. O evento de amostra deve ser JSON válido. 1. (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. ------ 1. (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](eb-transform-target-input.md#eb-transform-input-examples). 1. 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. 1. 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](eb-transform-target-input.md#eb-transform-input-examples). 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. 1. 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 "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. 1. Selecione **Confirmar**. 1. Siga o restante das etapas para criar uma regra, conforme detalhado em [Criação de regras na Amazon EventBridge](eb-create-rule-visual.md). # Testando um transformador de entrada de destino usando o Sandbox EventBridge <a name="eb-sandbox-input-trans"></a> Você pode usar transformadores de entrada para personalizar o texto de um [evento](eb-events.md) antes de EventBridge passar as informações para o [destino](eb-targets.md) de uma [regra](eb-rules.md). A configuração de um transformador de entrada normalmente faz parte de um processo maior de especificar um destino ao [criar uma nova regra](eb-create-rule-visual.md) ou editar uma existente. No entanto EventBridge, usando o Sandbox in, você pode 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 EventBridge de insumos da Amazon](eb-transform-target-input.md). **Para testar um transformador de entrada de destino** 1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Em **Recursos do desenvolvedor**, escolha **Sandbox** e, na página **Sandbox**, escolha a guia **Transformador de entrada de destino**. 1. 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 **. 1. 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. 1. (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**. 1. 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. 1. (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**. 1. EventBridge preenche o evento de amostra com um modelo de atributos de evento necessários. 1. Edite e adicione ao evento de amostra conforme desejado. O evento de amostra deve ser JSON válido. 1. (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. ------ 1. (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](eb-transform-target-input.md#eb-transform-input-examples). 1. 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. 1. 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](eb-transform-target-input.md#eb-transform-input-examples). 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. 1. 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 "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.