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 ] } ] } }
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.
| Champ | Value |
|---|---|
aws:EventId | L'identifiant EventBridge attribué, renvoyé à l'éditeur sous la forme EventId |
aws:Source, aws:DetailType | Le 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:DeliveryType | LIVEpour 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, DeduplicationId | Tel que fourni au moment de la publication. Consultez Ordonnancement et dédoublonnage d’événements sur un bus d’événements personnalisé |
ContentType | Le 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:IngestionTime | Quand le bus a accepté l'événement |
aws:SequenceNumber | Position de l'événement dans le bus ; elle augmente avec l'ordre d'ingestion |
aws:SchemaId, aws:RegistryType | Le 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.