View a markdown version of this page

EventBridge struktur pesan acara - Amazon Simple Storage Service
Contoh struktur pesan peristiwaKolom detail pesan peristiwa

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

EventBridge struktur pesan acara

Pesan pemberitahuan yang dikirimkan Amazon S3 untuk menerbitkan kegiatan ada dalam format JSON. Saat Amazon S3 mengirim acara ke Amazon EventBridge, bidang berikut akan hadir.

  • version— Saat ini 0 (nol) untuk semua acara. Ini adalah bidang EventBridge amplop Amazon dan tidak digunakan untuk pembuatan versi skema. Untuk pembuatan versi skema peristiwa, lihat bidang event-version di bidang detail.

  • id— UUID yang dihasilkan untuk setiap acara.

  • detail-type— Jenis acara yang sedang dikirim. Lihat Menggunakan EventBridge untuk daftar jenis peristiwa.

  • source— Mengidentifikasi layanan yang menghasilkan acara.

  • account— Akun AWS ID 12 digit pemilik bucket.

  • time- Waktu peristiwa itu terjadi.

  • region— Men Wilayah AWS gidentifikasi ember.

  • resources— Sebuah array JSON yang berisi Amazon Resource Name (ARN) dari bucket.

  • detail— Objek JSON yang berisi informasi tentang acara tersebut. Untuk informasi selengkapnya tentang apa saja yang dapat disertakan dalam bidang ini, lihat Kolom detail pesan peristiwa.

Contoh struktur pesan peristiwa

Berikut ini adalah contoh dari beberapa pesan notifikasi peristiwa Amazon S3 yang dapat dikirim ke Amazon EventBridge.

Objek dibuat

{
  "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",
    "event-version": "1.1",
    "bucket": {
      "name": "amzn-s3-demo-bucket1",
      "aws-generated-tags": {
        "aws:cloudformation:stack-id": "arn:aws:cloudformation:us-east-1:111122223333:stack/amzn-s3-demo-stack/51af3dc0-da77-11e4-872e-1234567db123",
        "aws:cloudformation:logical-id": "S3DemoBucket",
        "aws:cloudformation:stack-name": "amzn-s3-demo-stack"
      }
    },
    "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"
  }
}

Objek dihapus (menggunakan 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",
    "event-version": "1.1",
    "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"
  }
}

Objek dihapus (menggunakan kedaluwarsa siklus hidup)

{
  "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",
    "event-version": "1.1",
    "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"
  }
}

Pemulihan objek selesai

{
  "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",
    "event-version": "1.1",
    "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"
  }
}

Anotasi objek dibuat

{
  "version": "0",
  "id": "8c2bfa57-4a67-b2ea-c4e0-6d420ea3b3a6",
  "detail-type": "Object Annotation Created",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2025-03-15T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "1.1",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
      "sequencer": "617f08299329d189"
    },
    "request-id": "4B4NGD358NMKJ12R",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "PutObjectAnnotation",
    "object-annotation": {
      "name": "my-annotation",
      "size": 24,
      "etag": "05df351ea190dffc26f55c74425b9d7a"
    }
  }
}

Anotasi objek dihapus

{
  "version": "0",
  "id": "a3d1bc94-5f82-c7e1-d290-7e531fb4c5b8",
  "detail-type": "Object Annotation Removed",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2025-03-15T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "1.1",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
      "sequencer": "617f08299329d190"
    },
    "request-id": "7C5NGD358NMKJ34S",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "DeleteObjectAnnotation",
    "object-annotation": {
      "name": "my-annotation"
    }
  }
}

Kolom detail pesan peristiwa

Bidang detail berisi objek JSON dengan informasi tentang peristiwa tersebut. Bidang berikut mungkin ada di bidang detail.

  • version— Saat ini 0 (nol) untuk semua acara.

  • event-version— Versi skema acara dalam bentuk major.minor (misalnya,1.1).

    Versi utama bertambah jika Amazon S3 membuat perubahan pada struktur peristiwa yang tidak kompatibel dengan versi sebelumnya. Ini termasuk menghapus bidang JSON yang sudah ada atau mengubah bagaimana isi bidang direpresentasikan (misalnya, format tanggal).

    Versi minor bertambah jika Amazon S3 membuat perubahan yang kompatibel ke belakang pada struktur acara. Ini termasuk menambahkan bidang baru ke struktur acara atau memperkenalkan jenis acara baru. Agar tetap kompatibel dengan versi minor baru dari struktur acara, sebaiknya aplikasi Anda mengabaikan bidang baru.

    Untuk memastikan aplikasi Anda dapat menguraikan struktur peristiwa dengan benar, kami menyarankan Anda melakukan perbandingan yang setara dengan nomor versi besar. Untuk memastikan bahwa bidang yang diharapkan oleh aplikasi Anda tersedia, kami juga menyarankan untuk melakukan perbandingan yang lebih besar dari pada versi minor.

  • bucket— Informasi tentang bucket Amazon S3 yang terlibat dalam acara tersebut.

  • aws-generated-tags— Tag yang melekat pada ember oleh AWS layanan. Hanya hadir ketika tag AWS yang dihasilkan ada di bucket. Bidang ini tidak ada untuk peristiwa replikasi lintas wilayah.

  • object— Informasi tentang objek Amazon S3 yang terlibat dalam acara tersebut.

  • request-id— Minta ID dalam tanggapan S3.

  • requester— Akun AWS ID atau AWS kepala layanan pemohon.

  • source-ip-address— Alamat IP sumber permintaan S3. Hanya terjadi untuk peristiwa yang dipicu oleh permintaan S3.

  • reason— Untuk acara Object Created, S3 API digunakan untuk membuat objek: PutObject, POST Object, CopyObject, atau CompleteMultipartUpload. Untuk peristiwa Object Deleted, ini disetel ke DeleteObject saat objek dihapus oleh panggilan API S3, atau Kedaluwarsa Sik lus Hidup saat objek dihapus oleh aturan kedaluwarsa Siklus Hidup S3. Untuk informasi selengkapnya, lihat Mengakhiri objek.

  • deletion-type- Untuk peristiwa Objek yang Dihapus, ketika objek yang tidak diberi versi dihapus, atau objek berversi dihapus secara permanen, ini disetel ke Dihapus Permanen. Saat penanda penghapusan dibuat untuk objek versi, ini diatur ke Hapus Penanda yang Dibuat. Untuk informasi selengkapnya, lihat Menghapus versi objek dari bucket dengan dukungan Penentuan Versi.

    catatan

    Beberapa atribut objek (seperti etag dansize) hanya hadir ketika penanda hapus dibuat.

  • restore-expiry-time— Untuk kejadian Object Restore Completed, waktu ketika salinan sementara objek akan dihapus dari S3. Untuk informasi selengkapnya, lihat Bekerja dengan objek yang diarsipkan.

  • source-storage-class- Untuk kejadian Object Restore Initi ated dan Object Restore Completed, kelas penyimpanan objek yang sedang dipulihkan. Untuk informasi selengkapnya, lihat Bekerja dengan objek yang diarsipkan.

  • destination-storage-class— Untuk peristiwa Object Storage Class Changed, kelas penyimpanan baru dari objek. Untuk informasi selengkapnya, lihat Transisi objek menggunakan Siklus Hidup Amazon S3.

  • destination-access-tier— Untuk peristiwa Tingkat Akses Ob jek Diubah, tingkat akses baru objek. Untuk informasi selengkapnya, lihat Mengelola biaya penyimpanan dengan Amazon S3 Intelligent-Tiering.

  • object-annotation— Untuk peristiwa Anotasi Objek yang Di buat dan Anotasi Objek Dihapus, detail bidang ini menyertakan object-annotation bidang yang berisi informasi tentang anotasi.

  • has-object-annotation— Untuk peristiwa Object Created dengan alasanCopyObject, object blok menyertakan bidang has-object-annotation boolean yang menunjukkan apakah objek yang disalin memiliki anotasi.