AWS metadatos de eventos de servicio - Amazon EventBridge
Evento personalizado válido mínimo

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS metadatos de eventos de servicio

Los siguientes campos aparecen en todos los eventos enviados 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

Una versión 4 UUID que se genera 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

Una JSON matriz que contiene los recursos ARNs que identifican los recursos involucrados en el evento. El servicio que genera el evento determina si se deben incluir o noARNs. Por ejemplo, los cambios de estado de las instancias de Amazon incluyen la EC2 instancia de AmazonARNs, los eventos de Auto Scaling incluyen ARNs tanto las instancias como los grupos de Auto Scaling, pero API las llamadas con AWS CloudTrail no incluyen el recursoARNs. EC2

detail

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

AWS APILos eventos de llamada tienen objetos detallados con aproximadamente 50 campos anidados en varios niveles de profundidad.

nota

PutEventsacepta datos en JSON formato. Para el tipo de datos JSON numérico (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 EC2 instancia de Amazon

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

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