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.
-
Ausführung – 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.
-
Quelle – Gibt den Service an, aus dem das Ereignis stammt.
-
Konto– Die 12-stellige AWS-Konto -ID des Bucket-Eigentümers.
-
Zeit – Die Zeit, zu der das Ereignis aufgetreten ist.
-
Region – Identifiziert den AWS-Region des Buckets.
-
Ressource – 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.
-
Ausführung – Derzeit 0 (Null) für alle Ereignisse.
-
Bucket – Informationen über den Amazon-S3-Bucket, der an der Veranstaltung beteiligt ist.
-
Objekt – Informationen über das an dem Ereignis beteiligte Amazon-S3-Objekt.
-
request-id – Anforderungs-ID in S3 Antwort.
-
Anforderer — AWS-Konto ID oder AWS Dienstprinzipal des Anfragenden.
-
source-ip-address— Quell-IP-Adresse der S3-Anfrage. Nur vorhanden für Ereignisse, die durch eine S3-Anfrage ausgelöst werden.
-
Grund — Bei Object Created-Ereignissen wurde die S3-API verwendet, um das Objekt zu erstellen: PutObject, POST-Objekt CopyObject, oder CompleteMultipartUpload. Bei Ereignissen mit gelöschtem Objekt ist dies so eingestellt, DeleteObjectwenn ein Objekt durch einen S3-API-Aufruf gelöscht wird, oder auf Lifecycle Expiration, 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“ ist dies 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 Ereignissen wie „Object Restore Initiated“ und „Object Restore Completed“ die Speicherklasse des wiederherzustellenden Objekts. Weitere Informationen finden Sie unter Arbeiten mit archivierten Objekten.
-
destination-storage-class— Bei Ereignissen vom Typ Object Storage Class Changed die neue Speicherklasse des Objekts. Weitere Informationen finden Sie unter Übertragen von Objekten mit Amazon-S3-Lebenszyklus.
-
destination-access-tier— Bei Ereignissen mit geänderter Objektzugriffsebene die neue Zugriffsebene des Objekts. Weitere Informationen finden Sie unter Mit Amazon S3 Intelligent-Tiering Speicherkosten verwalten.