Transformación de entradas de Amazon EventBridge

aws.events.rule-arn — El nombre de recurso de Amazon (ARN) de la regla de EventBridge.

aws.events.rule-name — El nombre de la regla de EventBridge.

aws.events.event.ingestion-time — La hora en la que EventBridge recibió el evento. Se trata de una marca de tiempo ISO 8601. EventBridge genera esta variable y no se puede sobrescribir.

aws.events.event — La carga del evento original en formato JSON (sin el campo detail). Solo se puede usar como valor para un campo JSON, ya que su contenido no está oculto.

aws.events.event.json — La carga del evento original en formato JSON (con el campo detail). Solo se puede usar como valor para un campo JSON, ya que su contenido no está oculto.

Para cadenas, se requieren comillas.

No hay validación al crear la ruta JSON para la plantilla.

Si especifica una variable que coincida con una ruta JSON que no existe en el evento, dicha variable no se crea ni aparece en la salida.

Las propiedades JSON como aws.events.event.json solo se pueden usar como el valor de un campo JSON, no en línea en otras cadenas.

EventBridge no oculta valores extraídos por la ruta de entrada al rellenar la plantilla de entrada para un destino.

Si una ruta JSON hace referencia a un objeto o matriz JSON, pero se hace referencia a la variable en una cadena, EventBridge elimina las comillas internas para garantizar la validez de la cadena. Por ejemplo, en el caso de una variable <detail> apuntada a $.detail, "El detalle es<detail>", EventBridge eliminaría las comillas del objeto.

Por lo tanto, si quiere generar un objeto JSON basado en una única variable de ruta JSON, debe colocarlo como clave. En este ejemplo, {"detail": <detail>}.

No se requieren comillas para las variables que representan cadenas. Están permitidas, pero EventBridge añade automáticamente comillas a los valores de las variables de cadena durante la transformación, para garantizar que el resultado de la transformación tenga un formato JSON válido. EventBridge no añade comillas a las variables que representan objetos o matrices JSON. No añada comillas a las variables que representan objetos o matrices JSON.

Por ejemplo, la siguiente plantilla de entrada incluye variables que representan tanto cadenas como objetos JSON:

{
  "ruleArn" : <aws.events.rule-arn>,
  "ruleName" : <aws.events.rule-name>,
  "originalEvent" : <aws.events.event.json>
}

El resultado es un formato JSON válido con las comillas adecuadas:

{
  "ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
  "ruleName" : "example",
  "originalEvent" : {
    ... // commented for brevity
  }
}

Para la salida de texto (que no sea JSON) como cadenas de varias líneas, escriba cada línea independiente de la plantilla de entrada entre comillas dobles.

Por ejemplo, si quisiera que el siguiente patrón de eventos coincidiera con eventos para resultados de Amazon Inspector:

{
  "detail": {
    "severity": ["HIGH"],
    "status": ["ACTIVE"]
  },
  "detail-type": ["Inspector2 Finding"],
  "source": ["inspector2"]
}

Y usando la siguiente ruta 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"
}

Podría usar la siguiente plantilla de entrada para generar una salida de cadena de varias líneas:

"<severity> severity finding <title>"
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"