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 wird.

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

• source— Identifiziert den Dienst, der das Ereignis generiert hat.

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

• time— Der Zeitpunkt, zu dem das Ereignis eingetreten ist.

• region— Identifiziert den 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 über den Amazon S3 S3-Bucket, der an der Veranstaltung beteiligt war.

• object— Informationen über das Amazon S3 S3-Objekt, das an dem Ereignis beteiligt war.

• request-id— Anforderungs-ID in der S3-Antwort.

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

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

• reason— Bei Ereignissen vom Typ Object Created wird die S3-API verwendet, um das Objekt zu erstellen: PutObjectPOST ObjectCopyObject,, 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— Bei Ereignissen mit gelöschtem Objekt, wenn ein Objekt ohne Version gelöscht wird oder wenn ein Objekt mit einer Version dauerhaft gelöscht wird, wird dies auf Dauerhaft gelöscht gesetzt. 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.