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

# Tutorial: Passe informações do evento para um AWS Batch alvo em um cronograma usando o transformador EventBridge de entrada
<a name="cwe-input-transformer"></a>

Você pode usar o transformador EventBridge de entrada para transmitir informações do evento AWS Batch em um envio de trabalho. Isso pode ser especialmente valioso se você invocar trabalhos como resultado de outras informações do evento AWS . Um exemplo é upload de objeto para um bucket do Amazon S3. Você também pode usar uma definição de tarefa com valores de substituição de parâmetros no comando do contêiner. O transformador EventBridge de entrada pode fornecer os valores dos parâmetros com base nos dados do evento. 

Depois, você cria um destino de AWS Batch evento que analisa as informações do evento que o inicia e as transforma em um `parameters` objeto. Quando o trabalho é executado, os parâmetros do evento do acionador são repassados para o comando do contêiner do trabalho.

**nota**  
Nesse cenário, todos os AWS recursos (como buckets, EventBridge regras e CloudTrail registros do Amazon S3) devem estar na mesma região.

**Para criar um AWS Batch alvo que usa o transformador de entrada**

1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Na barra de navegação, selecione o Região da AWS a ser usado.

1. No painel de navegação, escolha **Regras**.

1. Escolha **Criar Regra**.

1. Para **Nome**, especifique um nome exclusivo para seu ambiente de computação. O nome pode conter até 64 caracteres. Pode conter letras minúsculas, maiúsculas, números, hifens e (-) e sublinhados (\$1).
**nota**  
Uma regra não pode ter o mesmo nome de outra regra no mesmo barramento de eventos Região da AWS e no mesmo.

1. (Opcional) Em **Description**, insira uma descrição para a regra.

1. Em **Barramento de Eventos**, escolha o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, selecione **padrão**. Quando um AWS service (Serviço da AWS) em sua conta emite um evento, ele sempre vai para o ônibus de eventos padrão da sua conta.

1. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente.

1. Em **Rule type**, escolha **Schedule**.

1. Escolha **Continuar para criar a regra** ou **Avançar**.

1. Em **Schedule pattern**, siga um destes procedimentos:
   + Escolha **um cronograma refinado que seja executado em um horário específico, tal como 8:00 a.m. PST na primeira segunda-feira de cada mês** e insira a expressão cron. Para obter mais informações, consulte [Expressões Cron](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) no *Guia do EventBridge usuário da Amazon*.
   + Escolha **uma programação que seja executada em uma taxa regular, como a cada 10 minutos.** e, em seguida, insira uma expressão rate.

1. Escolha **Next** (Próximo).

1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**.

1. Em **Selecionar um destino**, escolha **Fila de trabalhos em lote**. Em seguida, configure o seguinte:
   + **Fila de trabalhos:** insira nome do recurso da Amazon (ARN) da fila de trabalhos na qual o trabalho será programado.
   + **Definição do trabalho:** insira o nome e a revisão ou ARN completo da definição do trabalho a ser usado.
   + **Nome do trabalho:** insira um nome para o trabalho.
   + **Tamanho da matriz:** (opcional) insira um tamanho de matriz para que o trabalho execute mais de uma cópia. Para obter mais informações, consulte [Trabalhos de matriz](array_jobs.md).
   + **Job attempts:** (opcional) insira o número de vezes para tentar novamente caso ocorra uma falha no trabalho. Para obter mais informações, consulte [Repetições de trabalho automatizadas](job_retries.md).

1. Para tipos de destino de **fila de trabalhos em Batch**, EventBridge precisa de permissão para enviar eventos para o destino. EventBridge pode criar a função do IAM necessária para que sua regra seja executada. Execute um destes procedimentos:
   + Para criar um perfil do IAM automaticamente, escolha **Create a new role for this specific resource**.
   + Para usar uma função do IAM que você criou anteriormente, escolha **Usar função existente**.

1. (Opcional) Expanda **Additional settings**.

1. Na seção **Additional settings**, para **Configure target input**, escolha **Input Transformer**.

1. Escolha **Configure input transformer**.

1. (Opcional) Para **evento de amostra**:

   1. Em **Tipo de evento de amostra**, escolha **AWS eventos**.

   1. Em **Eventos de amostra**, escolha **Batch Job State Change**.

1. Na seção **Target input transformer**, para **Input path**, especifique os valores a serem analisados no evento de acionamento. Por exemplo, para analisar o evento **Batch Job State Change**, use o seguinte formato JSON.

   ```
   {
       "instance": "$.detail.jobId",
       "state": "$.detail.status"
   }
   ```

1. Em **Template**, insira o seguinte:

   ```
   {
       "instance": <jobId> ,
       "status": <status>
   }
   ```

1. Escolha **Confirmar**.

1. Em **Idade máxima do evento**, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos.

1. Em **Tentativas de repetição**, insira o número de vezes que um evento é repetido.

1. Em **Dead-letter queue,** escolha uma opção de como os eventos não processados são tratados. Se necessário, especifique a fila do Amazon SQS para usar como fila de mensagens mortas.

1. (Opcional) Selecione **Add another target** (Adicionar outro destino) para adicionar outro destino a essa regra.

1. Escolha **Next** (Próximo).

1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** para adicionar um rótulo de recurso. Para obter mais informações, consulte as [ EventBridge tags da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) no *Guia EventBridge do usuário da Amazon*.

1. Escolha **Próximo**.

1. Para **Revisar e criar**, revise as etapas de configuração. Se precisar fazer alterações, escolha **Edit** (Editar). Quando terminar, escolha **Create rule**.