Configuración de un transformador de entrada al crear una regla en EventBridge

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 Creación de reglas que reaccionan a eventos en Amazon EventBridge.

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 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 evento de AWS, un evento de socio 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 Eventos de ejemplo, seleccione el evento de AWS deseado. Los eventos se organizan por servicio de AWS.

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

      Por ejemplo, si elige Creación de objeto de Amazon S3, EventBridge muestra un ejemplo de evento de creación de un objeto de Amazon S3.

   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 que admiten EventBridge, como Salesforce.

   1. Seleccione Eventos de socios de EventBridge.

   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 EventBridge envía al destino

   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 datos del evento de origen original en el evento transformado que EventBridge transfiere 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 evento de AWS Creación de objeto de Amazon S3 como 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 quiere usar para determinar lo que EventBridge transfiere al destino.

   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 en Salida la salida transformada generada. Esta es la información que EventBridge 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 Creación de reglas que reaccionan a eventos en Amazon EventBridge.