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 ] } ] } }
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.
| Campo | Valor |
|---|---|
aws:EventId | El identificador EventBridge asignado, devuelto al editor como EventId |
aws:Source, aws:DetailType | La 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:DeliveryType | LIVEpara 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, DeduplicationId | Tal y como se suministró en el momento de la publicación. Consulte Ordenar y deduplicar eventos en un bus de eventos personalizado |
ContentType | El 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:IngestionTime | Cuando el autobús aceptó el evento |
aws:SequenceNumber | La posición del evento en el autobús; aumenta con el orden de ingesta |
aws:SchemaId, aws:RegistryType | El 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.