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 notifikasi yang dikirimkan Amazon S3 untuk mempublikasikan suatu acara ada dalam format. JSON Saat Amazon S3 mengirim acara ke Amazon EventBridge, bidang berikut hadir.

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

  • id - Versi 4 UUID yang dihasilkan untuk setiap acara.

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

  • source—Mengidentifikasi layanan yang menghasilkan peristiwa.

  • account—ID 12 digit Akun AWS dari pemilik bucket.

  • time—Waktu peristiwa terjadi.

  • region—Mengidentifikasi Wilayah AWS dari bucket tersebut.

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

  • detail — JSON Objek 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 pemberitahuan acara 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",
    "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"
  }
}

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",
    "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",
    "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",
    "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"
  }
}

Kolom detail pesan peristiwa

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

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

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

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

  • request-id—ID permintaan dalam respons S3.

  • pemohon — Akun AWS ID atau prinsip AWS layanan pemohon.

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

  • alasan — Untuk peristiwa Object Created, S3 API digunakan untuk membuat objek: PutObject, POSTObject, CopyObject, atau CompleteMultipartUpload. Untuk peristiwa Object Deleted, ini diatur ke DeleteObjectsaat objek dihapus oleh API panggilan S3, atau Kedaluwarsa Siklus Hidup saat objek dihapus oleh aturan kedaluwarsa Siklus Hidup S3. Untuk informasi selengkapnya, lihat Mengakhiri objek.

  • deletion-type—Untuk peristiwa Object Deleted, ketika objek yang tidak berversi dihapus, atau objek berversi dihapus secara permanen, ini diatur ke Permanently Deleted. 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) hadir hanya ketika penanda hapus dibuat.

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

  • source-storage-class— Untuk peristiwa Object Restore Inisiated dan Object Restore Completed, kelas penyimpanan objek dipulihkan. Untuk informasi selengkapnya, lihat Bekerja dengan objek yang diarsipkan.

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

  • destination-access-tier— Untuk acara Object Access Tier Changed, tingkat akses baru objek. Untuk informasi selengkapnya, lihat Mengelola biaya penyimpanan dengan Amazon S3 Intelligent-Tiering.