View a markdown version of this page

Estructura del evento: datos, metadatos y metadatos del sistema - Amazon EventBridge

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.

Estructura del evento: datos, metadatos y metadatos del sistema

Los filtros, los transformadores y los parámetros de destino comparten un modelo de direccionamiento. EventBridge entrega cada evento con tres nombres de nivel superior: Data contiene la carga útil, Metadata contiene las claves que ha suministrado y SystemMetadata contiene los campos que asigna. PutRawEvents EventBridge La ubicación de tus propios campos Data depende de la API de publicación. Ambas API producen el mismo tipo de evento y EventBridge filtran y transforman ambas de la misma manera. La diferencia es solo lo que está dentroData.

Parte Publicado con PutRawEvents Publicado con PutEvents
Data Tu carga útil, exactamente como se envió Un sobre consource, detail-typetime, y otros campos. Su carga útil es el valor dedetail.
Metadata Tus claves de metadatos No presente
SystemMetadata Campos asignados por EventBridge Campos asignados por EventBridge

Una expresión de JSonata ve el evento como. $events El mismo identificador de pedido se encuentra en una ruta diferente para cada API.

Publicado conPutRawEvents:

$events.Data.orderId

Publicado conPutEvents:

$events.Data.detail.orderId

La misma diferencia se aplica a un filtro con un alcance deDATA. El patrón se escribe contra el contenido deData.

Publicado conPutRawEvents:

{ "total": [ { "numeric": [ ">", 500 ] } ] }

Publicado conPutEvents:

{ "detail": { "total": [ { "numeric": [ ">", 500 ] } ] } }
importante

Una expresión o patrón escrito para la forma incorrecta no falla. No produce ningún resultado, el filtro no coincide con ningún evento y el transformador no produce ninguna salida. Un suscriptor cuyo filtro no coincide con nada tiene el mismo aspecto que un suscriptor que no funciona. Antes de confiar en un suscriptor, publica un evento que deba coincidir y otro que no, y confirma que ambos resultados cumplen con el objetivo. Si los productores publican con ambas API en el mismo bus, asigne a cada tipo de tráfico sus propios suscriptores.

SystemMetadata campos

SystemMetadataes el mismo para ambas API y es la única parte del evento que escribe EventBridge por sí misma. Un filtro con un rango de SYSTEM_METADATA coincidencias en su contra, y una expresión de JSonata lo lee como. $events.SystemMetadata Cada valor es una cadena. EventBridge omite un campo que no tiene ningún valor, por lo que una referencia de JSonata a él se evalúa comoundefined; only aws:DeliveryType está siempre presente. En la siguiente tabla se enumeran los campos.

CampoValor
aws:EventIdEl identificador EventBridge asignado, devuelto al editor como EventId
aws:Source, aws:DetailTypeLa entrada es Source y DetailType paraPutEvents; el servicio o socio de origen y su tipo de evento para una fuente de eventos. Ninguna convocatoria de publicación puede establecer una fuente que comience poraws., por lo que {"aws:Source":["aws.s3"]} demuestra que Amazon S3 produjo el evento
aws:DeliveryTypeLIVEpara un evento entregado tal como llegó, REPLAY para un evento leído del historial conservado. Consulte Reproducción de eventos retenidos para un suscriptor
EventGroupId, DeduplicationIdTal y como se suministró en el momento de la publicación. Consulte Ordenar y deduplicar eventos en un bus de eventos personalizado
ContentTypeEl tipo de contenido tal como se publicó: application/eventbridge+json forPutEvents; forPutRawEvents, el valor de la entrada, por lo que los datos de Avro y Protobuf EventBridge descodificados en JSON aún muestran o application/avro application/protobuf
aws:IngestionTimeCuando el autobús aceptó el evento
aws:SequenceNumberLa posición del evento en el autobús; aumenta con el orden de ingesta
aws:SchemaId, aws:RegistryTypeEl esquema y el registro utilizados para deserializar una carga útil de Avro o Protobuf; de lo contrario, están ausentes

Metadatasolo está presente en los eventos publicados con PutRawEvents esa configuración; para todos los demás eventos, está vacío. Forapplication/octet-stream, Data es una cadena en Base64. En una Transformer expresión $events hay un evento; solo en un objetivo universal Input es una matriz. Consulte Transformación de eventos con JSonata.