View a markdown version of this page

Structure de l'événement : données, métadonnées et métadonnées du système - Amazon EventBridge

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Structure de l'événement : données, métadonnées et métadonnées du système

Les filtres, les transformateurs et les paramètres cibles partagent un même modèle d'adressage. EventBridge distribue chaque événement sous trois noms de premier niveau : Data contient la charge utile, Metadata contient les clés que vous avez fournies et SystemMetadata contient les PutRawEvents champs qui EventBridge les attribuent. L'emplacement de vos propres champs Data dépend de l'API de publication. Les deux API produisent le même type d'événement et EventBridge filtrent et transforment les deux de la même manière. La seule différence réside dans ce qui se trouve à l'intérieurData.

Partie Publié avec PutRawEvents Publié avec PutEvents
Data Votre charge utile, exactement telle qu'elle a été envoyée Une enveloppe contenantsource, detail-typetime, et d'autres champs. Votre charge utile est la valeur de. detail
Metadata Vos clés de métadonnées Absent
SystemMetadata Champs attribués par EventBridge Champs attribués par EventBridge

Une expression JSonata considère l'événement comme. $events Le même identifiant de commande se trouve sur un chemin différent pour chaque API.

Publié avec PutRawEvents :

$events.Data.orderId

Publié avec PutEvents :

$events.Data.detail.orderId

La même différence s'applique à un filtre dont la portée est deDATA. Le motif est écrit par rapport au contenu deData.

Publié avec PutRawEvents :

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

Publié avec PutEvents :

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

Une expression ou un motif écrit pour une forme incorrecte n'échoue pas. Il se résout à néant, le filtre ne correspond à aucun événement et le transformateur ne produit aucune sortie. Un abonné dont le filtre ne correspond à rien semble identique à un abonné qui ne fonctionne pas. Avant de compter sur un abonné, publiez un événement qui devrait correspondre et un autre qui ne devrait pas correspondre, et confirmez les deux résultats par rapport à l'objectif. Si les producteurs publient avec les deux API sur le même bus, attribuez à chaque type de trafic ses propres abonnés.

SystemMetadata champs

SystemMetadataest identique pour les deux API et constitue la seule partie de l'événement qui EventBridge s'écrit elle-même. Un filtre avec une étendue de SYSTEM_METADATA correspondances, et une expression JSonata le lit comme. $events.SystemMetadata Chaque valeur est une chaîne. EventBridge omet un champ qui n'a aucune valeur, donc une référence JSonata à celui-ci est évaluée comme undefined ; only aws:DeliveryType est toujours présent. Le tableau suivant répertorie les champs.

ChampValue
aws:EventIdL'identifiant EventBridge attribué, renvoyé à l'éditeur sous la forme EventId
aws:Source, aws:DetailTypeLe nom Source et le but DetailType de l'entrée PutEvents ; le service ou le partenaire d'origine et son type d'événement pour une source d'événement. Aucun appel de publication ne peut définir une source commençant paraws., ce qui {"aws:Source":["aws.s3"]} prouve qu'Amazon S3 a produit l'événement
aws:DeliveryTypeLIVEpour un événement organisé au fur et à mesure, REPLAY pour une lecture d'un extrait de l'histoire conservée. Consultez Rediffusion des événements enregistrés à un abonné
EventGroupId, DeduplicationIdTel que fourni au moment de la publication. Consultez Ordonnancement et dédoublonnage d’événements sur un bus d’événements personnalisé
ContentTypeLe type de contenu tel que publié : application/eventbridge+json for PutEvents ; forPutRawEvents, la valeur de l'entrée, afin que les données Avro et Protobuf EventBridge décodées au format JSON soient toujours affichées ou application/avro application/protobuf
aws:IngestionTimeQuand le bus a accepté l'événement
aws:SequenceNumberPosition de l'événement dans le bus ; elle augmente avec l'ordre d'ingestion
aws:SchemaId, aws:RegistryTypeLe schéma et le registre utilisés pour désérialiser une charge utile Avro ou Protobuf ; sinon, ils sont absents

Metadatan'est présent que pour les événements publiés avec PutRawEvents ce paramètre ; pour tous les autres événements, il est vide. Forapplication/octet-stream, Data est une chaîne Base64. Dans une Transformer expression, $events il y a un événement ; ce n'est que dans une cible universelle qu'il s'Inputagit d'un tableau. Consultez Transformer les événements avec JSonata.