Transformación EventBridge de entradas de Amazon

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

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

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

aws.events.event— La carga útil del evento original es JSON (sin el detail campo). Solo se puede usar como valor para un JSON campo, ya que su contenido no se escapa.

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

Para cadenas, se requieren comillas.

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

Si especificas una variable para que coincida con una JSON ruta que no existe en el evento, esa variable no se crea y no aparecerá en la salida.

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

EventBridge no escapa a los valores extraídos por la ruta de entrada al rellenar la plantilla de entrada de un objetivo.

Si una JSON ruta hace referencia a un JSON objeto o matriz, pero se hace referencia a la variable en una cadena, EventBridge elimina las comillas internas para garantizar que la cadena sea válida. Por ejemplo, en el caso de una variable <detail> señalada <detail>como «El detalle es»$.detail, se EventBridge eliminarían las comillas del objeto.

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

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

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

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

El resultado es válido JSON con la cotización adecuada:

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

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

Por ejemplo, si comparas los eventos de Amazon Inspector Finding con el siguiente patrón de eventos:

{
  "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"
}

Puede usar la siguiente plantilla de entrada para generar una salida de cadena multilínea:

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