Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan EventBridge
Amazon S3 dapat mengirim acara ke Amazon EventBridge setiap kali peristiwa tertentu terjadi di bucket Anda. Tidak seperti tujuan lain, Anda tidak perlu memilih jenis peristiwa mana yang ingin Anda kirimkan. Setelah EventBridge diaktifkan, semua acara di bawah ini dikirim ke EventBridge. Anda dapat menggunakan EventBridge aturan untuk merutekan acara ke target tambahan. Berikut ini mencantumkan peristiwa yang dikirimkan Amazon S3. EventBridge
| Tipe peristiwa | Deskripsi |
| --- | --- |
| *Objek Dibuat* | Sebuah objek telah dibuat. Bidang alasan dalam struktur pesan peristiwa menunjukkan S3 API mana yang digunakan untuk membuat objek: [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html),, [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), atau [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). |
| *Objek Dihapus (DeleteObject)* *Objek Dihapus (Kedaluwarsa siklus hidup)* | Sebuah objek telah dihapus. Saat objek dihapus menggunakan panggilan API S3, bidang alasan disetel keDeleteObject. Saat objek dihapus oleh aturan kedaluwarsa Siklus Hidup S3, bidang alasan disetel ke Kedaluwarsa Siklus Hidup. Untuk informasi selengkapnya, lihat [Mengakhiri objek](lifecycle-expire-general-considerations.md). Ketika objek yang tidak berversi dihapus, atau objek berversi dihapus secara permanen, bidang tipe penghapusan disetel ke. Permanently Deleted Ketika penanda hapus dibuat untuk objek berversi, `deletion-type` bidang diatur ke. Delete Marker Created Untuk informasi selengkapnya, lihat [Menghapus versi objek dari bucket dengan dukungan Penentuan Versi](DeletingObjectVersions.md). |
| *Pemulihan Objek Dimulai* | Pemulihan objek dimulai dari kelas penyimpanan S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive atau dari tingkat S3 Intelligent-Tiering Archive Access atau Deep Archive Access. Untuk informasi selengkapnya, lihat [Bekerja dengan objek yang diarsipkan](archived-objects.md). |
| *Pemulihan Objek Selesai* | Pemulihan objek selesai. |
| *Pemulihan Objek Kedaluwarsa* | Salinan sementara objek yang dipulihkan dari S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive kedaluwarsa dan telah dihapus. |
| *Kelas Penyimpanan Objek Berubah* | Sebuah objek dialihkan ke kelas penyimpanan yang berbeda. Untuk informasi selengkapnya, lihat [Transisi objek menggunakan Siklus Hidup Amazon S3](lifecycle-transition-general-considerations.md). |
| *Tingkat Akses Objek Berubah* | Sebuah objek dialihkan ke tingkat S3 Intelligent-Tiering Archive Access atau tingkat Akses Arsip Dalam. Untuk informasi selengkapnya, lihat [Mengelola biaya penyimpanan dengan Amazon S3 Intelligent-Tiering](intelligent-tiering.md). |
| *Objek ACL Diperbarui* | Daftar kontrol akses objek (ACL) ditetapkan menggunakan`PutObjectAcl`. Peristiwa tidak dihasilkan ketika permintaannya tidak menghasilkan perubahan pada ACL objek. Untuk informasi selengkapnya, lihat [Gambaran umum daftar kontrol akses (ACL)](acl-overview.md). |
| *Tag Objek Ditambahkan* | Satu set tag ditambahkan ke objek menggunakan`PutObjectTagging`. Untuk informasi selengkapnya, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). |
| *Tag Objek Dihapus* | Semua tag telah dihapus dari objek menggunakan`DeleteObjectTagging`. Untuk informasi selengkapnya, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). |
**catatan**
Untuk informasi selengkapnya tentang cara memetakan jenis peristiwa Amazon S3 ke jenis EventBridge acara, lihat. [EventBridge Pemetaan dan pemecahan masalah Amazon](ev-mapping-troubleshooting.md)
Anda dapat menggunakan Pemberitahuan Acara Amazon S3 EventBridge untuk menulis aturan yang mengambil tindakan saat peristiwa terjadi di bucket Anda. Misalnya, Anda dapat mengirimi Anda pemberitahuan. Untuk informasi lebih lanjut, lihat [Apa itu EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) di *Panduan EventBridge Pengguna Amazon*.
Untuk informasi selengkapnya tentang tindakan dan tipe data yang dapat berinteraksi dengan menggunakan EventBridge API, lihat Referensi [Amazon EventBridge API di Referensi](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html) *Amazon EventBridge API*.
Untuk informasi tentang harga, lihat [ EventBridge harga Amazon](https://aws.amazon.com/eventbridge/pricing).
**Topics**
+ [EventBridge Izin Amazon](ev-permissions.md)
+ [Mengaktifkan Amazon EventBridge](enable-event-notifications-eventbridge.md)
+ [EventBridge struktur pesan acara](ev-events.md)
+ [EventBridge Pemetaan dan pemecahan masalah Amazon](ev-mapping-troubleshooting.md)
# EventBridge Izin Amazon
Amazon S3 tidak memerlukan izin tambahan untuk mengirimkan acara ke Amazon. EventBridge
# Mengaktifkan Amazon EventBridge
Anda dapat mengaktifkan Amazon EventBridge dengan menggunakan konsol S3, AWS Command Line Interface (AWS CLI), atau Amazon S3 REST API.
**catatan**
Setelah Anda mengaktifkan EventBridge, dibutuhkan sekitar lima menit agar perubahan diterapkan.
## Menggunakan konsol S3
**Untuk mengaktifkan pengiriman EventBridge acara di konsol S3.**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Dalam daftar bucket, pilih nama bucket tempat Anda ingin mengaktifkan event.
1. Pilih **Properti**.
1. Arahkan ke bagian **Pemberitahuan Acara** dan temukan EventBridge subbagian **Amazon**. Pilih **Edit**.
1. Di bawah **Kirim notifikasi ke Amazon EventBridge untuk semua acara di bucket ini** pilih **Aktif**.
## Menggunakan AWS CLI
Contoh berikut membuat konfigurasi notifikasi bucket untuk bucket *`amzn-s3-demo-bucket1`* dengan Amazon EventBridge diaktifkan.
```
aws s3api put-bucket-notification-configuration --bucket amzn-s3-demo-bucket1 --notification-configuration='{ "EventBridgeConfiguration": {} }'
```
## Penggunaan API REST
Anda dapat mengaktifkan Amazon secara terprogram EventBridge di bucket dengan memanggil Amazon S3 REST API. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) dalam *Referensi API Amazon Simple Storage Service*.
Contoh berikut menunjukkan XHTML yang digunakan untuk membuat konfigurasi notifikasi bucket dengan Amazon EventBridge diaktifkan.
```
```
## Membuat EventBridge aturan
Setelah diaktifkan, Anda dapat membuat EventBridge aturan Amazon untuk tugas tertentu. Misalnya, Anda dapat mengirim notifikasi email ketika objek dibuat. Untuk tutorial selengkapnya, lihat [Tutorial: Mengirim pemberitahuan saat objek Amazon S3 dibuat](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-s3-object-created-tutorial.html) di * EventBridge Panduan Pengguna Amazon*.
# 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 hadir.
+ `version`— Saat ini 0 (nol) untuk semua acara.
+ `id`— UUID yang dihasilkan untuk setiap acara.
+ `detail-type`— Jenis acara yang sedang dikirim. Lihat [Menggunakan EventBridge](EventBridge.md) untuk daftar jenis peristiwa.
+ `source`— Mengidentifikasi layanan yang menghasilkan acara.
+ `account`— 12 digit Akun AWS ID pemilik bucket.
+ `time`- Waktu peristiwa itu terjadi.
+ `region`— Mengidentifikasi ember. Wilayah AWS
+ `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](#ev-events-detail).
## Contoh struktur pesan peristiwa
Berikut ini adalah contoh dari beberapa pesan notifikasi 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 objek JSON dengan informasi tentang peristiwa tersebut. Bidang berikut mungkin ada di bidang detail.
+ `version`— Saat ini 0 (nol) untuk semua acara.
+ `bucket`— Informasi tentang bucket Amazon S3 yang terlibat dalam acara tersebut.
+ `object`— Informasi tentang objek Amazon S3 yang terlibat dalam acara tersebut.
+ `request-id`— Minta ID dalam respons S3.
+ `requester`— 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.
+ `reason`— Untuk peristiwa **Object Created**, API S3 digunakan untuk membuat objek: [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html),, [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), atau [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). Untuk peristiwa **Object Deleted**, ini diatur ke **DeleteObject**saat objek dihapus oleh panggilan API S3, atau Kedaluwarsa **Siklus Hidup saat objek dihapus oleh aturan kedaluwarsa** Siklus Hidup S3. Untuk informasi selengkapnya, lihat [Mengakhiri objek](lifecycle-expire-general-considerations.md).
+ `deletion-type`**— Untuk peristiwa **Object Deleted**, ketika objek yang tidak berversi dihapus, atau objek berversi dihapus secara permanen, ini diatur ke Dihapus Secara 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](DeletingObjectVersions.md).
**catatan**
Beberapa atribut objek (seperti `etag` dan`size`) 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](archived-objects.md).
+ `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](archived-objects.md).
+ `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](lifecycle-transition-general-considerations.md).
+ `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](intelligent-tiering.md).
# EventBridge Pemetaan dan pemecahan masalah Amazon
Tabel berikut menjelaskan bagaimana jenis peristiwa Amazon S3 dipetakan ke jenis peristiwa Amazon EventBridge .
| Jenis peristiwa S3 | Jenis EventBridge detail Amazon |
| --- | --- |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html) | Objek Dibuat |
| ObjectRemoved:Delete ObjectRemoved:DeleteMarkerCreated LifecycleExpiration:Delete LifecycleExpiration:DeleteMarkerCreated | Object Deleted |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html) | Pemulihan Objek Dimulai |
| ObjectRestore:Completed | Pemulihan Objek Selesai |
| ObjectRestore:Delete | Pemulihan Objek Kedaluwarsa |
| LifecycleTransition | Kelas Penyimpanan Objek Berubah |
| IntelligentTiering | Tingkat Akses Objek Berubah |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) | Tag Objek Ditambahkan |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html) | Tag Objek Dihapus |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html) | Objek ACL Diperbarui |
## EventBridge Pemecahan masalah Amazon
Untuk informasi tentang cara memecahkan masalah EventBridge, lihat [Memecahkan Masalah Amazon EventBridge di Panduan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) Pengguna *Amazon EventBridge *.