EventBridge Struktur der Ereignisnachricht - Amazon Simple Storage Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

EventBridge Struktur der Ereignisnachricht

Die Benachrichtigung, die Amazon S3 sendet, um ein Ereignis zu veröffentlichen, verwendet das JSON-Format. Wenn Amazon S3 ein Ereignis an Amazon sendet EventBridge, sind die folgenden Felder vorhanden.

  • version – Derzeit 0 (Null) für alle Ereignisse.

  • id – Eine UUID, die für jedes Ereignis generiert wurde.

  • detail-type – Die Art des Ereignisses, das gesendet wird. Eine Liste der Ereignistypen finden Sie unter Verwenden EventBridge.

  • source – Identifiziert den Service, aus dem das Ereignis stammt.

  • account— Die 12-stellige AWS-Konto ID des Bucket-Besitzers.

  • time – Der Zeitpunkt, an dem das Ereignis aufgetreten ist.

  • region— Identifiziert die AWS-Region des Buckets.

  • resources – Ein JSON-Array, das den Amazon-Ressourcennamen (ARN) des Buckets enthält.

  • detail – Ein JSON-Objekt, das Informationen zum Ereignis enthält. Weitere Informationen dazu, was in diesem Feld enthalten sein kann, finden Sie unter Detailfeld für Ereignismeldung.

Beispiele für Ereignismeldungen

Im Folgenden finden Sie Beispiele für einige der Amazon S3 S3-Ereignisbenachrichtigungen, die an Amazon gesendet werden können EventBridge.

Objekt erstellt

{ "version": "0", "id": "17793124-05d4-b198-2fde-7ededc63b103", "detail-type": "Object Created", "source": "aws.s3", "account": "111122223333", "time": "2021-11-12T00:00:00Z", "region": "ca-central-1", "resources": [ "arn:aws:s3:::amzn-s3-demo-bucket1" ], "detail": { "version": "0", "bucket": { "name": "amzn-s3-demo-bucket1" }, "object": { "key": "example-key", "size": 5, "etag": "b1946ac92492d2347c6235b4d2611184", "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e", "sequencer": "617f08299329d189" }, "request-id": "N4N7GDK58NMKJ12R", "requester": "123456789012", "source-ip-address": "1.2.3.4", "reason": "PutObject" } }

Objekt wurde gelöscht (mithilfe von DeleteObject)

{ "version": "0", "id": "2ee9cc15-d022-99ea-1fb8-1b1bac4850f9", "detail-type": "Object Deleted", "source": "aws.s3", "account": "111122223333", "time": "2021-11-12T00:00:00Z", "region": "ca-central-1", "resources": [ "arn:aws:s3:::amzn-s3-demo-bucket1" ], "detail": { "version": "0", "bucket": { "name": "amzn-s3-demo-bucket1" }, "object": { "key": "example-key", "etag": "d41d8cd98f00b204e9800998ecf8427e", "version-id": "1QW9g1Z99LUNbvaaYVpW9xDlOLU.qxgF", "sequencer": "617f0837b476e463" }, "request-id": "0BH729840619AG5K", "requester": "123456789012", "source-ip-address": "1.2.3.4", "reason": "DeleteObject", "deletion-type": "Delete Marker Created" } }

Objekt wurde gelöscht (unter Verwendung des Lebenszyklusablaufs)

{ "version": "0", "id": "ad1de317-e409-eba2-9552-30113f8d88e3", "detail-type": "Object Deleted", "source": "aws.s3", "account": "111122223333", "time": "2021-11-12T00:00:00Z", "region": "ca-central-1", "resources": [ "arn:aws:s3:::amzn-s3-demo-bucket1" ], "detail": { "version": "0", "bucket": { "name": "amzn-s3-demo-bucket1" }, "object": { "key": "example-key", "etag": "d41d8cd98f00b204e9800998ecf8427e", "version-id": "mtB0cV.jejK63XkRNceanNMC.qXPWLeK", "sequencer": "617b398000000000" }, "request-id": "20EB74C14654DC47", "requester": "s3.amazonaws.com", "reason": "Lifecycle Expiration", "deletion-type": "Delete Marker Created" } }

Objektwiederherstellung abgeschlossen

{ "version": "0", "id": "6924de0d-13e2-6bbf-c0c1-b903b753565e", "detail-type": "Object Restore Completed", "source": "aws.s3", "account": "111122223333", "time": "2021-11-12T00:00:00Z", "region": "ca-central-1", "resources": [ "arn:aws:s3:::amzn-s3-demo-bucket1" ], "detail": { "version": "0", "bucket": { "name": "amzn-s3-demo-bucket1" }, "object": { "key": "example-key", "size": 5, "etag": "b1946ac92492d2347c6235b4d2611184", "version-id": "KKsjUC1.6gIjqtvhfg5AdMI0eCePIiT3" }, "request-id": "189F19CB7FB1B6A4", "requester": "s3.amazonaws.com", "restore-expiry-time": "2021-11-13T00:00:00Z", "source-storage-class": "GLACIER" } }

Detailfeld für Ereignismeldung

Das Detailfeld enthält ein JSON-Objekt mit Informationen über das Ereignis. Die folgenden Felder können im Detailfeld vorhanden sein.

  • version – Derzeit 0 (Null) für alle Ereignisse.

  • bucket – Informationen zum Amazon S3-Bucket, der an dem Event beteiligt ist.

  • object – Informationen über das an dem Ereignis beteiligte Amazon-S3-Objekt.

  • request-id – Anforderungs-ID in S3 Antwort.

  • requester— AWS-Konto ID oder AWS Dienstleiter des Anforderers.

  • source-ip-address – Quell-IP-Adresse der S3-Anforderung. Nur vorhanden für Ereignisse, die durch eine S3-Anfrage ausgelöst werden.

  • reason – Bei Ereignissen vom Typ Object wird die S3-API verwendet, um das Objekt zu erstellen: PutObject, POST Object, CopyObject, oder CompleteMultipartUpload. Für Object Deleted-Ereignisse wird dies auf DeleteObject gesetzt, wenn ein Objekt durch einen S3-API-Aufruf gelöscht wird, oder Lebenszyklusablauf, wenn ein Objekt durch eine S3-Lebenszyklus-Ablaufregel gelöscht wird. Weitere Informationen finden Sie unter Ablauf von Objekten.

  • deletion-type – Wenn ein nicht versioniertes Objekt gelöscht wird oder ein versioniertes Objekt dauerhaft gelöscht wird, wird bei Object Deleted-Ereignissen dies auf Permanently Deleted festgelegt. Wenn ein Löschmarker für ein versioniertes Objekt erstellt wird, wird dieser auf Löschmarkierung erstellt gesetzt. Weitere Informationen finden Sie unter Löschen von Objekten aus einem versioning-fähigen Bucket.

    Anmerkung

    Einige Objektattribute (wie etag undsize) sind nur vorhanden, wenn eine Löschmarkierung erstellt wird.

  • restore-expiry-time – Bei Ereignissen Objektwiederherstellung abgeschlossen der Zeitpunkt, zu dem die temporäre Kopie des Objekts aus S3 gelöscht wird. Weitere Informationen finden Sie unter Arbeiten mit archivierten Objekten.

  • source-storage-class – Bei den Ereignissen Objektwiederherstellung eingeleitet und Objektwiederherstellung abgeschlossen die Speicherklasse des wiederherzustellenden Objekts. Weitere Informationen finden Sie unter Arbeiten mit archivierten Objekten.

  • destination-storage-class – Für Ereignisse Objektspeicherklasse geändert die neue Speicherklasse des Objekts. Weitere Informationen finden Sie unter Übertragen von Objekten mit Amazon-S3-Lebenszyklus.

  • destination-access-tier – Für Ereignisse Objektzugriffebene geändert die neue Zugriffebene des Objekts. Weitere Informationen finden Sie unter Mit Amazon S3 Intelligent-Tiering Speicherkosten verwalten.