EventBridge Struktur der Ereignisnachricht - Amazon Simple Storage Service
Beispiele für EreignismeldungenDetailfeld für Ereignismeldung

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 zur Veröffentlichung eines Ereignisses sendet, hat das folgende 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 Version 4, die für jedes Ereignis UUID generiert wird.

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

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

  • detail — Ein JSON Objekt, das Informationen über das 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 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.

  • Grund — Für Object Created-Ereignisse wurde das S3 API verwendet, um das Objekt zu erstellen: PutObject, POSTObject CopyObject, oder CompleteMultipartUpload. DeleteObjectBei Ereignissen mit gelöschtem Objekt ist dies so eingestellt, dass ein Objekt durch einen API S3-Aufruf gelöscht wird, oder Lifecycle Expiration, wenn ein Objekt durch eine S3-Lebenszyklus-Ablaufregel gelöscht wird. Weitere Informationen finden Sie unter Auslaufende Objekte.

  • 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öschmarke erstellt wird.

  • restore-expiry-time— Bei Ereignissen mit Abschluss der Objektwiederherstellung 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 Übergang 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 Amazon S3 Intelligent Tiering.