Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Configurar un transformador de entrada al crear una regla en EventBridge
<a name="eb-transform-input-rule"></a>

Como parte de la creación de una regla, puede especificar un transformador de entrada que se utilizará EventBridge para procesar los eventos coincidentes antes de enviarlos al destino especificado. Puede configurar transformadores de entrada para destinos que sean AWS servicios o destinos de API.

**Para crear un transformador de entrada de destino como parte de una regla**

1. Siga los pasos para crear una regla que se detallan en [Crear reglas en Amazon EventBridge](eb-create-rule-visual.md).

1. En el paso **3: Seleccionar destino(s)**, expanda **Configuración adicional**.

1. En **Configurar entrada de destino**, seleccione **Transformador de entrada** en el menú desplegable.

   Haga clic en **Configurar transformador de entrada**.

   EventBridge muestra el cuadro de diálogo **Configurar el transformador de entrada**.

1. En la sección **Evento de muestra**, seleccione un **tipo de evento de muestra** con el que desee probar su patrón de eventos. Puede elegir un AWS evento, un evento asociado o introducir su propio evento personalizado.

------
#### [ AWS events ]

   Seleccione uno de los eventos emitidos desde Servicios de AWS compatibles.

   1. Seleccione **Eventos de AWS **.

   1. En **Ejemplos de eventos**, selecciona el AWS evento que desees. Los eventos se organizan por AWS servicio.

      Al seleccionar un evento, EventBridge rellena el evento de muestra.

      Por ejemplo, si elige **S3 Object Created**, EventBridge muestra un ejemplo de evento S3 Object Created.

   1. (Opcional) También puede seleccionar **Copiar** para copiar el evento de muestra en el portapapeles de tu dispositivo.

------
#### [ Partner events ]

   Seleccione entre los eventos emitidos por servicios de terceros compatibles EventBridge, como Salesforce.

   1. Seleccione los **eventos de los EventBridge socios.**

   1. En **Eventos de ejemplo**, seleccione el evento de socio deseado. Los eventos se organizan por socio.

      Al seleccionar un evento, EventBridge rellena el evento de muestra.

   1. (Opcional) También puede seleccionar **Copiar** para copiar el evento de muestra en el portapapeles de tu dispositivo.

------
#### [ Enter your own ]

   Introduzca su propio evento en texto JSON.

   1. Seleccione **Introducir el suyo**.

   1. EventBridge rellena el evento de muestra con una plantilla de los atributos de evento necesarios.

   1. Edite el evento de muestra y añádalo según desee. El evento de muestra debe tener un formato JSON válido.

   1. (Opcional) También puede elegir una de las siguientes opciones:
      + **Copiar**: copia el evento de muestra en el portapapeles de su dispositivo.
      + **Prettify**: facilita la lectura del texto JSON al añadir saltos de línea, tabulaciones y espacios.

------

1. (Opcional) Amplíe la sección **Ejemplos de rutas de entrada, plantillas y salidas** para ver ejemplos de:
   + Cómo se utilizan las rutas JSON para definir las variables que representan datos de eventos
   + Cómo se pueden usar esas variables en una plantilla de transformador de entrada
   + La salida resultante que se EventBridge envía al objetivo

   Para ver ejemplos más detallados de transformaciones de entradas, consulte [Ejemplos de transformación de entradas](eb-transform-target-input.md#eb-transform-input-examples).

1. En la sección **Transformador de entrada de destino**, defina las variables que desee utilizar en la plantilla de entrada.

   Variables que utilizan la ruta JSON para hacer referencia a valores en el origen del evento original. A continuación, puede hacer referencia a esas variables en la plantilla de entrada para incluir los datos del evento de origen original en el evento transformado que EventBridge pasa al destino. Puede definir hasta 100 variables. El transformador de entrada debe tener un formato JSON válido.

   Por ejemplo, supongamos que ha elegido el AWS evento **S3 Object Created** como su evento de muestra para este transformador de entrada. A continuación, podría definir las siguientes variables para usarlas en su plantilla:

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

   (Opcional) También puede elegir **Copiar** para copiar el transformador de entrada al portapapeles de su dispositivo.

1. En la sección **Plantilla**, redacte la plantilla que desee usar para determinar qué EventBridge pasará al objetivo.

   Puede usar formato JSON, cadenas, información estática, variables que haya definido y variables reservadas. Para ver ejemplos más detallados de transformaciones de entradas, consulte [Ejemplos de transformación de entradas](eb-transform-target-input.md#eb-transform-input-examples).

   Suponga, por ejemplo, que ha definido las variables en el ejemplo anterior. A continuación, podría crear la siguiente plantilla, que haga referencia a esas variables, así como a las variables reservadas y a la información estática.

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

   (Opcional) También puede elegir **Copiar** para copiar la plantilla al portapapeles de su dispositivo.

1. Para probar su plantilla, seleccione **Generar salida**.

   EventBridge procesa el evento de muestra en función de la plantilla de entrada y muestra la salida transformada generada en **Salida**. Esta es la información que EventBridge se transferirá al destino en lugar del evento de origen original.

   El resultado generado para la plantilla de entrada de ejemplo descrita anteriormente sería el siguiente:

   ```
   {
       "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) También puede elegir **Copiar** para copiar la salida generada al portapapeles de su dispositivo.

1. Seleccione **Confirmar**.

1. Siga el resto de los pasos para crear una regla, tal como se detalla en [Crear reglas en Amazon EventBridge](eb-create-rule-visual.md).