Referencia de la estructura de un evento

Los siguientes campos aparecen en todos los eventos que se envían a un bus de eventos y comprenden los metadatos del evento:

{
  "versión": "0",
  "id": "UUID",
  "tipo-detalle": "event name",
  "source": "event source",
  "cuenta": "ARN",
  "hora": "timestamp",
  "región": "region",
  "resources": [
    "ARN"
  ],
  "detail": {
    JSON object
  }
}

versión

De forma predeterminada, está definida en 0 (cero) en todos los eventos.

id

Un UUID de versión 4 generado para cada evento. Puede usar id para hacer un seguimiento de los eventos a medida que pasan de las reglas a los destinos.

tipo-detalle

Identifica, en combinación con el campo source, los campos y los valores que aparecen en detail.

Los eventos que son entregados por CloudTrail tienen AWS API Call via CloudTrail como valordetail-type.

source

Identifica el servicio que generó el evento. Todos los eventos que provienen de servicios de AWS empiezan por “aws”. Los eventos generados por el cliente pueden tener cualquier valor aquí, salvo que no pueden empezar por "aws". Le recomendamos que utilice cadenas de nombres de dominio inversas que utilicen el estilo de nombres de paquetes de Java.

Para encontrar el valor correcto de un AWS servicio, consulte la tabla de claves de condición, seleccione un servicio de la lista y busque el prefijo del servicio. source Por ejemplo, el source valor de Amazon CloudFront esaws.cloudfront.

cuenta

El número de 12 dígitos que identifica una AWS cuenta.

hora

La marca temporal del evento, que puede especificar el servicio que origina el evento. Si el evento abarca un intervalo de tiempo, el servicio puede notificar la hora de inicio, por lo que este valor puede ser anterior al momento en que se recibe el evento.

región

Identifica la AWS región en la que se originó el evento.

resources

Esta matriz JSON contiene ARN que identifican recursos que participan en el evento. El servicio que genera el evento determina si se deben incluir estos ARN. Por ejemplo, los cambios de estado de instancia de Amazon EC2 incluyen los ARN de instancia de Amazon EC2, los eventos de escalado automático incluyen los ARN tanto para instancias como para grupos de escalado automático, pero las llamadas a la API con AWS CloudTrail no incluyen los ARN de recursos.

detail

Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo. Puede ser "{}".

AWS Los eventos de llamada a la API tienen objetos detallados con aproximadamente 50 campos anidados en varios niveles de profundidad.

nota

PutEventsacepta datos en formato JSON. Para el tipo de datos número JSON (entero), las restricciones son: un valor mínimo de -9.223.372.036.854.775.808 y un valor máximo de 9.223.372.036.854.775.807.

ejemplo Ejemplo: Notificación de cambio de estado de una instancia de Amazon EC2

El siguiente evento en Amazon EventBridge indica que se está cancelando una instancia de Amazon EC2.

{
  "version": "0",
  "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
  "detail-type": "EC2 Instance State-change Notification",
  "source": "aws.ec2",
  "account": "111122223333",
  "time": "2017-12-22T18:43:48Z",
  "region": "us-west-1",
  "resources": [
    "arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0"
  ],
  "detail": {
    "instance-id": " i-1234567890abcdef0",
    "state": "terminated"
  }
}

Información mínima necesaria para un evento personalizado válido

Al crear eventos personalizados, estos deben incluir los siguientes campos:

• detail

• detail-type

• source

{
  "detail-type": "event name",
  "source": "event source",
  "detail": {
  }
}