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 que se entregan a un bus de eventos y comprenden los metadatos del evento:

{
  "versión": "0",
  "id": "UUID",
  "detail-type": "event name",
  "source": "event source",
  "inscrita": "ARN",
  "hora": "timestamp",
  "region": "region",
  "recursos": [
    "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.

detail-type

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.

inscrita

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.

region

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

recursos

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

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