Configuración de un transformador de entrada como parte de la creación de una regla

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 de Amazon EventBridge que reaccionan a eventos.

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

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

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

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

   3. (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.

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

   3. (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.

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

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

   4. (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.

5. (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.

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

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

   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.

8. 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 "example-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.

9. Seleccione Confirmar.

10. Siga el resto de los pasos para crear una regla, tal como se detalla en Crear reglas de Amazon EventBridge que reaccionan a eventos.