Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Notifikasi Peristiwa Amazon S3 Anda dapat menggunakan fitur Notifikasi Peristiwa Amazon S3 untuk menerima pemberitahuan ketika peristiwa tertentu terjadi di bucket S3 Anda. Untuk mengaktifkan notifikasi, tambahkan konfigurasi notifikasi yang mengidentifikasi peristiwa yang ingin dipublikasikan Amazon S3. Pastikan itu juga mengidentifikasi tujuan tempat Anda ingin Amazon S3 mengirim notifikasi. Anda menyimpan konfigurasi ini di sub-sumber daya *notifikasi* yang terkait dengan bucket. Untuk informasi selengkapnya, lihat [Opsi konfigurasi bucket tujuan umum](UsingBucket.md#bucket-config-options-intro). Amazon S3 menyediakan API bagi Anda untuk dapat mengelola sub-sumber daya ini. **penting** Pemberitahuan peristiwa Amazon S3 dirancang untuk dikirimkan setidaknya satu kali. Biasanya, pemberitahuan peristiwa dikirimkan dalam hitungan detik, tetapi terkadang perlu waktu satu menit atau lebih. ## Gambaran Umum Notifikasi Peristiwa Amazon S3 Saat ini, Amazon S3 dapat menerbitkan pemberitahuan untuk peristiwa berikut: + Objek baru yang dibuat peristiwa + Peristiwa penghapusan objek + Kembalikan peristiwa objek + Mengurangi objek Penyimpanan Redundansi (RRS) yang hilang + Peristiwa replikasi + Acara kedaluwarsa Siklus Hidup S3 + Peristiwa transisi Siklus Hidup S3 + S3 Intelligent-Tiering peristiwa arsip otomatis + Peristiwa pemberian tag objek + Peristiwa objek ACL PUT Untuk deskripsi lengkap semua jenis peristiwa yang didukung, lihat [Jenis event yang didukung untuk SQS, SNS, dan Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types). Amazon S3 dapat mengirimkan pesan pemberitahuan peristiwa ke tujuan berikut. Anda menentukan nilai Amazon Resource Name (ARN) dari tujuan ini dalam konfigurasi notifikasi. + Topik Amazon Simple Notification Service (Amazon SNS) + Antrean Amazon Simple Queue Service (Amazon SQS) + AWS Lambda fungsi + Amazon EventBridge Untuk informasi selengkapnya, lihat [Tujuan peristiwa yang didukung](notification-how-to-event-types-and-destinations.md#supported-notification-destinations). **catatan** Antrean Amazon Simple Queue Service FIFO (First-In-First-Out) tidak didukung sebagai tujuan pemberitahuan peristiwa Amazon S3. Untuk mengirim pemberitahuan untuk acara Amazon S3 ke antrian FIFO Amazon SQS, Anda dapat menggunakan Amazon. EventBridge Untuk informasi selengkapnya, lihat [Mengaktifkan Amazon EventBridge](enable-event-notifications-eventbridge.md). **Awas** Jika notifikasi Anda akhirnya menulis ke bucket yang sama yang memicu notifikasi, ini dapat menyebabkan loop eksekusi. Misalnya, jika bucket memicu fungsi Lambda setiap kali suatu objek diunggah, dan fungsinya mengunggah sebuah objek ke bucket, maka fungsi tersebut secara tidak langsung memicu fungsi itu sendiri. Untuk menghindari hal ini, gunakan dua bucket, atau konfigurasikan pemicu agar hanya berlaku pada prefiks yang digunakan untuk objek masuk. *Untuk informasi selengkapnya dan contoh penggunaan notifikasi Amazon S3 dengan AWS Lambda, lihat [Menggunakan AWS Lambda dengan Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3.html) di AWS Lambda Panduan Pengembang.* Untuk informasi selengkapnya tentang jumlah konfigurasi notifikasi peristiwa yang dapat Anda buat per bucket, lihat [Kuota layanan Amazon S3](https://docs.aws.amazon.com/general/latest/gr/s3.html#limits_s3) dalam *AWS Referensi Umum*. Untuk informasi selengkapnya tentang notifikasi Peristiwa, lihat bagian berikut. **Topics** + [ ## Gambaran Umum Notifikasi Peristiwa Amazon S3 ](#notification-how-to-overview) + [ # Jenis dan tujuan pemberitahuan peristiwa ](notification-how-to-event-types-and-destinations.md) + [ # Menggunakan Amazon SQS, Amazon SNS, dan Lambda ](how-to-enable-disable-notification-intro.md) + [ # Menggunakan EventBridge ](EventBridge.md) # Jenis dan tujuan pemberitahuan peristiwa Amazon S3 mendukung beberapa jenis tujuan notifikasi peristiwa tempat notifikasi dapat diterbitkan. Anda dapat menentukan jenis peristiwa dan tujuan ketika mengonfigurasi notifikasi peristiwa Anda. Hanya satu tujuan yang dapat ditentukan untuk setiap pemberitahuan peristiwa. Pemberitahuan peristiwa Amazon S3 mengirim satu entri peristiwa untuk setiap pesan notifikasi. **Topics** + [ ## Tujuan peristiwa yang didukung ](#supported-notification-destinations) + [ ## Jenis event yang didukung untuk SQS, SNS, dan Lambda ](#supported-notification-event-types) + [ ## Jenis acara yang didukung untuk Amazon EventBridge ](#supported-notification-event-types-eventbridge) + [ ## Pemesanan acara dan duplikat acara ](#event-ordering-and-duplicate-events) ## Tujuan peristiwa yang didukung Amazon S3 dapat mengirimkan pesan pemberitahuan peristiwa ke tujuan berikut. + Topik Amazon Simple Notification Service (Amazon SNS) + Antrean Amazon Simple Queue Service (Amazon SQS) + AWS Lambda + Amazon EventBridge Namun, hanya satu jenis tujuan yang dapat ditentukan untuk setiap pemberitahuan peristiwa. **catatan** Anda harus memberikan izin Amazon S3 untuk mem-posting pesan ke topik Amazon SNS atau antrean Amazon SQS. Anda juga harus memberikan izin Amazon S3 untuk menjalankan AWS Lambda fungsi atas nama Anda. Untuk petunjuk tentang cara memberikan izin ini, lihat [memberikan izin untuk memublikasikan pesan pemberitahuan peristiwa ke tujuan](grant-destinations-permissions-to-s3.md). ### Topik Amazon SNS Amazon SNS adalah layanan perpesanan push yang fleksibel, dan dikelola penuh. Anda dapat menggunakan layanan ini untuk mendorong pesan ke perangkat seluler atau layanan terdistribusi. Dengan SNS, Anda dapat memublikasikan pesan satu kali, dan mengirimkannya satu atau beberapa kali. Saat ini SNS Standar hanya diizinkan sebagai tujuan notifikasi peristiwa S3, sedangkan SNS FIFO tidak diizinkan. Amazon SNS mengoordinasikan dan mengelola pengiriman dan pengiriman pesan ke titik akhir atau klien yang berlangganan. Anda dapat menggunakan konsol Amazon SNS untuk membuat topik Amazon SNS yang dapat dikirimkan pemberitahuan Anda. Topiknya harus Wilayah AWS sama dengan bucket Amazon S3 Anda. Untuk petunjuk tentang cara membuat topik Amazon SNS, lihat [Memulai dengan Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) di *Panduan Pengembang Amazon Simple Notification Service* dan [FAQ Amazon SNS](https://aws.amazon.com/sns/faqs/). Sebelum Anda dapat menggunakan topik Amazon SNS yang Anda buat sebagai tujuan pemberitahuan peristiwa, Anda memerlukan hal berikut: + Amazon Resource Name (ARN) untuk topik Amazon SNS + Berlangganan topik Amazon SNS yang valid. Dengan itu, pelanggan topik diberi tahu saat pesan dipublikasikan ke topik Amazon SNS Anda. ### Antrean Amazon SQS Amazon SQS menawarkan antrean hostingan yang andal dan dapat diskalakan untuk menyimpan pesan saat mereka bepergian antar komputer. Anda dapat menggunakan Amazon SQS untuk mengirimkan volume data apa pun tanpa memerlukan layanan lain untuk selalu tersedia. Anda dapat menggunakan konsol Amazon SQS untuk membuat antrean Amazon SQS yang dapat dikirimkan pemberitahuan Anda. Antrian Amazon SQS harus sama Wilayah AWS dengan bucket Amazon S3 Anda. Untuk petunjuk tentang cara membuat antrean Amazon SQS, lihat [Apa itu Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html) dan [Memulai dengan Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-getting-started.html) di *Panduan Pengembang Amazon Simple Storage Service*. Sebelum Anda dapat menggunakan antrean Amazon SQS sebagai tujuan pemberitahuan peristiwa, Anda memerlukan berikut ini: + Amazon Resource Name (ARN) untuk antrean Amazon SQS **catatan** Antrean Amazon Simple Queue Service FIFO (First-In-First-Out) tidak didukung sebagai tujuan pemberitahuan peristiwa Amazon S3. Untuk mengirim pemberitahuan untuk acara Amazon S3 ke antrian FIFO Amazon SQS, Anda dapat menggunakan Amazon. EventBridge Untuk informasi selengkapnya, lihat [Mengaktifkan Amazon EventBridge](enable-event-notifications-eventbridge.md). ### Fungsi Lambda Anda dapat menggunakan AWS Lambda untuk memperluas AWS layanan lain dengan logika khusus, atau membuat backend Anda sendiri yang beroperasi pada AWS skala, kinerja, dan keamanan. Dengan Lambda, Anda dapat membuat aplikasi terpisah berbasis peristiwa yang berjalan hanya saat diperlukan. Anda juga dapat menggunakannya untuk menskalakan aplikasi ini secara otomatis dari beberapa permintaan sehari hingga ribuan detik. Lambda dapat menjalankan kode kustom sebagai respons terhadap peristiwa bucket Amazon S3. Anda unggah kode kustom Anda ke Lambda dan membuat apa yang disebut fungsi Lambda. Saat Amazon S3 mendeteksi peristiwa dari jenis tertentu, Amazon S3 dapat memublikasikan acara ke AWS Lambda dan memanggil fungsi Anda di Lambda. Sebagai respons, Lambda menjalankan fungsi Anda. Salah satu jenis peristiwa yang mungkin dideteksi, misalnya, adalah peristiwa yang dibuat objek. Anda dapat menggunakan AWS Lambda konsol untuk membuat fungsi Lambda yang menggunakan AWS infrastruktur untuk menjalankan kode atas nama Anda. Fungsi Lambda harus berada di Wilayah yang sama dengan bucket S3. Anda juga harus memiliki nama atau ARN dari fungsi Lambda untuk mengatur fungsi Lambda sebagai tujuan notifikasi peristiwa. **Awas** Jika notifikasi Anda akhirnya menulis ke bucket yang sama yang memicu notifikasi, ini dapat menyebabkan loop eksekusi. Misalnya, jika bucket memicu fungsi Lambda setiap kali suatu objek diunggah, dan fungsinya mengunggah sebuah objek ke bucket, maka fungsi tersebut secara tidak langsung memicu fungsi itu sendiri. Untuk menghindari hal ini, gunakan dua bucket, atau konfigurasikan pemicu agar hanya berlaku pada prefiks yang digunakan untuk objek masuk. *Untuk informasi selengkapnya dan contoh penggunaan notifikasi Amazon S3 dengan AWS Lambda, lihat [Menggunakan AWS Lambda dengan Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3.html) di AWS Lambda Panduan Pengembang.* ### Amazon EventBridge Amazon EventBridge adalah bus acara tanpa server, yang menerima acara dari AWS layanan. Anda dapat mengatur aturan untuk mencocokkan peristiwa dan mengirimkannya ke target, seperti layanan AWS atau titik akhir HTTP. Untuk informasi selengkapnya, lihat [Apa yang ada EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) di *Panduan EventBridge Pengguna Amazon*. Tidak seperti tujuan lain, Anda dapat mengaktifkan atau menonaktifkan acara yang akan dikirimkan EventBridge untuk ember. Jika Anda mengaktifkan pengiriman, semua acara dikirim ke EventBridge. Selain itu, Anda dapat menggunakan EventBridge aturan untuk merutekan acara ke target tambahan. ## Jenis event yang didukung untuk SQS, SNS, dan Lambda Amazon S3 dapat menerbitkan peristiwa dari jenis berikut. Anda menentukan jenis peristiwa ini di konfigurasi pemberitahuan. | Jenis peristiwa | Deskripsi | | --- | --- | | `s3:TestEvent` | Ketika notifikasi diaktifkan, Amazon S3 menerbitkan notifikasi tes. Hal ini untuk memastikan bahwa topik ada dan bahwa pemilik bucket memiliki izin untuk mempublikasikan topik tertentu. Jika mengaktifkan notifikasi gagal, Anda tidak menerima notifikasi tes. | | `s3:ObjectCreated:*` `s3:ObjectCreated:Put` `s3:ObjectCreated:Post` `s3:ObjectCreated:Copy` `s3:ObjectCreated:CompleteMultipartUpload` | Operasi API Amazon S3 seperti`PUT`,`POST`, dan `COPY` dapat membuat objek. Dengan jenis peristiwa ini, Anda dapat mengaktifkan notifikasi saat objek dibuat menggunakan operasi API tertentu. Atau, Anda dapat menggunakan jenis peristiwa `s3:ObjectCreated:*` untuk meminta notifikasi terlepas dari API yang digunakan untuk membuat objek. `s3:ObjectCreated:CompleteMultipartUpload`termasuk objek yang dibuat menggunakan [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html)untuk operasi Salin. | | `s3:ObjectRemoved:*` `s3:ObjectRemoved:Delete` `s3:ObjectRemoved:DeleteMarkerCreated` | Dengan menggunakan tipe peristiwa `ObjectRemoved`, Anda dapat mengaktifkan pemberitahuan saat objek atau batch objek dihapus dari bucket. Anda dapat meminta pemberitahuan saat objek dihapus atau objek versi dihapus secara permanen menggunakan jenis peristiwa `s3:ObjectRemoved:Delete`. Atau, Anda dapat meminta notifikasi saat penanda penghapusan dibuat untuk objek versi menggunakan `s3:ObjectRemoved:DeleteMarkerCreated`. Untuk petunjuk cara menghapus objek berversi, lihat [Menghapus versi objek dari bucket dengan dukungan Penentuan Versi](DeletingObjectVersions.md). Anda juga dapat menggunakan wildcard `s3:ObjectRemoved:*` untuk meminta pemberitahuan kapan pun sebuah objek dihapus. Pemberitahuan peristiwa ini tidak memperingatkan Anda untuk penghapusan otomatis dari konfigurasi siklus aktif atau dari operasi yang gagal. | | `s3:ObjectRestore:*` `s3:ObjectRestore:Post` `s3:ObjectRestore:Completed` `s3:ObjectRestore:Delete` | Dengan menggunakan jenis `ObjectRestore` acara, Anda dapat menerima pemberitahuan untuk inisiasi dan penyelesaian acara saat memulihkan objek dari kelas penyimpanan Pengambilan Fleksibel Gletser S3, kelas penyimpanan S3 Glacier Deep Archive, tingkat Akses Arsip Tingkat Cerdas S3, dan tingkat Akses Arsip Tingkat Cerdas S3. Anda juga dapat menerima pemberitahuan ketika salinan objek yang dipulihkan kedaluwarsa. Jenis peristiwa `s3:ObjectRestore:Post` memberi tahu Anda tentang inisiasi restorasi objek. Jenis peristiwa `s3:ObjectRestore:Completed` memberi tahu Anda tentang penyelesaian restorasi. Jenis peristiwa `s3:ObjectRestore:Delete` memberi tahu Anda saat salinan sementara objek yang dipulihkan kedaluwarsa. | | s3:ReducedRedundancyLostObject | Anda menerima peristiwa notifikasi ini saat Amazon S3 mendeteksi bahwa objek kelas penyimpanan RRS hilang. | | `s3:Replication:*` `s3:Replication:OperationFailedReplication` `s3:Replication:OperationMissedThreshold` `s3:Replication:OperationReplicatedAfterThreshold` `s3:Replication:OperationNotTracked` | Dengan menggunakan jenis `Replication` acara, Anda dapat menerima pemberitahuan untuk konfigurasi replikasi yang mengaktifkan metrik Replikasi S3 atau Kontrol Waktu Replikasi S3 (S3 RTC). Anda dapat memantau minute-by-minute kemajuan peristiwa replikasi dengan melacak byte yang tertunda, operasi tertunda, dan latensi replikasi. Untuk informasi tentang metrik replikasi, lihat [Memantau replikasi dengan metrik, pemberitahuan acara, dan status](replication-metrics.md). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonS3/latest/userguide/notification-how-to-event-types-and-destinations.html) | | `s3:LifecycleExpiration:*` `s3:LifecycleExpiration:Delete` `s3:LifecycleExpiration:DeleteMarkerCreated` | Dengan menggunakan jenis `LifecycleExpiration` acara, Anda dapat menerima pemberitahuan saat Amazon S3 menghapus objek berdasarkan konfigurasi Siklus Hidup S3 Anda. Jenis peristiwa `s3:LifecycleExpiration:Delete` akan memberi tahu Anda saat objek dalam bucket yang tidak berversi dihapus. Ini juga memberi tahu Anda ketika versi objek dihapus secara permanen oleh konfigurasi Siklus Hidup S3. Jenis peristiwa `s3:LifecycleExpiration:DeleteMarkerCreated` akan memberi tahu Anda saat Siklus Hidup S3 membuat penanda hapus saat versi objek saat ini dalam bucket berversi dihapus. | | s3:LifecycleTransition | Anda menerima peristiwa notifikasi ini saat objek dialihkan ke kelas penyimpanan Amazon S3 lainnya dengan konfigurasi Siklus Hidup S3. | | s3:IntelligentTiering | Anda menerima peristiwa notifikasi ini ketika objek dalam kelas penyimpanan S3 Intelligent-Tiering pindah ke tingkat Archive Access atau tingkat Deep Archive Access. | | `s3:ObjectTagging:*` `s3:ObjectTagging:Put` `s3:ObjectTagging:Delete` | Dengan menggunakan jenis `ObjectTagging` acara, Anda dapat mengaktifkan notifikasi saat tag objek ditambahkan atau dihapus dari objek. Jenis peristiwa `s3:ObjectTagging:Put` memberi tahu Anda saat tag PUT pada objek atau tag yang ada diperbarui. Jenis peristiwa `s3:ObjectTagging:Delete` memberi tahu Anda saat tag dihapus dari objek. | | s3:ObjectAcl:Put | Anda menerima peristiwa pemberitahuan ini ketika ACL PUT pada objek atau ketika ACL yang ada diubah. Peristiwa tidak dihasilkan ketika permintaannya tidak menghasilkan perubahan pada ACL objek. | ## Jenis acara yang didukung untuk Amazon EventBridge Untuk daftar jenis acara yang akan dikirimkan Amazon S3 ke Amazon EventBridge, lihat. [Menggunakan EventBridge](EventBridge.md) ## Pemesanan acara dan duplikat acara Pemberitahuan Acara Amazon S3 dirancang untuk mengirimkan pemberitahuan setidaknya sekali, tetapi pemberitahuan tersebut tidak dijamin tiba dalam urutan yang sama dengan peristiwa yang terjadi. Pada kesempatan yang jarang terjadi, mekanisme coba ulang Amazon S3 dapat menyebabkan duplikat Pemberitahuan Acara S3 untuk peristiwa objek yang sama. *Untuk selengkapnya tentang penanganan peristiwa duplikat atau di luar pesanan, lihat [Mengelola pemesanan acara dan duplikat peristiwa dengan Pemberitahuan Acara Amazon S3](https://aws.amazon.com/blogs/storage/manage-event-ordering-and-duplicate-events-with-amazon-s3-event-notifications/) di AWS Blog Penyimpanan.* # Menggunakan Amazon SQS, Amazon SNS, dan Lambda Mengaktifkan notifikasi adalah operasi tingkat bucket. Anda menyimpan konfigurasi notifikasi di sub-sumber daya *notifikasi* yang berasosiasi dengan bucket. Setelah Anda membuat atau mengubah konfigurasi notifikasi bucket, biasanya diperlukan waktu sekitar lima menit sampai perubahan diterapkan. `s3:TestEvent` terjadi ketika notifikasi pertama kali diaktifkan. Anda dapat menggunakan salah satu metode berikut untuk mengelola konfigurasi pemberitahuan: + **Menggunakan konsol Amazon S3**—Anda dapat menggunakan UI konsol untuk mengatur konfigurasi notifikasi pada bucket tanpa harus tulis kode apa pun. Untuk informasi selengkapnya, lihat [Mengaktifkan dan mengonfigurasi notifikasi peristiwa menggunakan konsol Amazon S3](enable-event-notifications.md). + **Secara terprogram menggunakan AWS SDKs** — Secara internal, baik konsol maupun SDKs panggilan Amazon S3 REST API untuk mengelola subresource *notifikasi* yang terkait dengan bucket. Untuk contoh konfigurasi notifikasi yang menggunakan SDK AWS , lihat [Panduan: Mengonfigurasi bucket untuk notifikasi (topik SNS atau antrean SQS)](ways-to-add-notification-config-to-bucket.md). **catatan** Anda juga dapat melakukan panggilan API REST Amazon S3 secara langsung dari kode Anda. Namun, ini dapat merepotkan karena untuk melakukannya Anda harus menulis kode untuk mengautentikasi permintaan Anda. Terlepas dari metode yang Anda gunakan, Amazon S3 menyimpan konfigurasi notifikasi sebagai XL di sub-sumber daya *notifikasi* yang terkait dengan bucket. Untuk informasi tentang sub-sumber daya bucket, lihat [Opsi konfigurasi bucket tujuan umum](UsingBucket.md#bucket-config-options-intro). **catatan** Jika Anda memiliki beberapa pemberitahuan peristiwa gagal karena tujuan yang dihapus, Anda mungkin menerima **Tidak dapat memvalidasi konfigurasi tujuan berikut** saat mencoba menghapusnya. Anda dapat mengatasi ini di konsol S3 dengan menghapus semua notifikasi yang gagal secara bersamaan. **Topics** + [ # memberikan izin untuk memublikasikan pesan pemberitahuan peristiwa ke tujuan ](grant-destinations-permissions-to-s3.md) + [ # Mengaktifkan dan mengonfigurasi notifikasi peristiwa menggunakan konsol Amazon S3 ](enable-event-notifications.md) + [ ## Mengonfigurasi notifikasi peristiwa secara terprogram ](#event-notification-configuration) + [ # Panduan: Mengonfigurasi bucket untuk notifikasi (topik SNS atau antrean SQS) ](ways-to-add-notification-config-to-bucket.md) + [ # Mengonfigurasi notifikasi peristiwa dengan filter nama kunci objek ](notification-how-to-filtering.md) + [ # Struktur pesan peristiwa ](notification-content-structure.md) # memberikan izin untuk memublikasikan pesan pemberitahuan peristiwa ke tujuan Anda harus memberikan izin yang diperlukan kepada pengguna utama Amazon S3 untuk memanggil API terkait guna menerbitkan pesan ke topik SNS, antrean SQS, atau fungsi Lambda. Hal ini agar Amazon S3 dapat memublikasikan pesan pemberitahuan peristiwa ke tujuan. Untuk memecahkan masalah memublikasikan pesan pemberitahuan peristiwa ke tujuan, lihat [ Memecahkan masalah untuk memublikasikan pemberitahuan peristiwa Amazon S3 ke topik Layanan Pemberitahuan Sederhana Amazon ](https://repost.aws/knowledge-center/sns-not-receiving-s3-event-notifications). **Topics** + [ ## Memberikan izin untuk menjalankan fungsi AWS Lambda ](#grant-lambda-invoke-permission-to-s3) + [ ## memberikan izin untuk memublikasikan pesan ke topik SNS atau antrean SQS ](#grant-sns-sqs-permission-for-s3) ## Memberikan izin untuk menjalankan fungsi AWS Lambda Amazon S3 menerbitkan pesan peristiwa AWS Lambda dengan menjalankan fungsi Lambda dan menyediakan pesan acara sebagai argumen. Saat Anda menggunakan konsol Amazon S3 untuk mengonfigurasi notifikasi peristiwa pada bucket Amazon S3 untuk fungsi Lambda, konsol menyiapkan izin yang diperlukan pada fungsi Lambda. Ini agar Amazon S3 memiliki izin untuk menginvokasi fungsi dari bucket. Untuk informasi selengkapnya, lihat [Mengaktifkan dan mengonfigurasi notifikasi peristiwa menggunakan konsol Amazon S3](enable-event-notifications.md). Anda juga dapat memberikan izin Amazon S3 dari AWS Lambda untuk menjalankan fungsi Lambda Anda. Untuk informasi selengkapnya, lihat [Tutorial: Menggunakan AWS Lambda Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3-example.html) di Panduan *AWS Lambda Pengembang*. ## memberikan izin untuk memublikasikan pesan ke topik SNS atau antrean SQS Untuk memberikan izin Amazon S3 untuk memublikasikan pesan ke topik SNS atau antrean SQS, lampirkan kebijakan AWS Identity and Access Management (IAM) ke topik SNS tujuan atau antrean SQS. Sebagai contoh cara melampirkan kebijakan ke topik SNS atau antrean SQS, lihat [Panduan: Mengonfigurasi bucket untuk notifikasi (topik SNS atau antrean SQS)](ways-to-add-notification-config-to-bucket.md). Untuk informasi lebih lanjut tentang izin, lihat topik berikut: + [Contoh kasus untuk kendali akses Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/AccessPolicyLanguage_UseCases_Sns.html) dalam *Panduan Amazon Simple Notification Service* + [Manajemen Identitas dan Akses di Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/UsingIAM.html) dalam *Panduan Pengembang Amazon Simple Queue Service* ### Kebijakan IAM untuk topik SNS tujuan Berikut ini adalah contoh kebijakan AWS Identity and Access Management (IAM) yang Anda lampirkan ke topik SNS tujuan. Untuk petunjuk tentang cara menggunakan kebijakan ini untuk menyiapkan topik Amazon SNS tujuan untuk pemberitahuan peristiwa, lihat [Panduan: Mengonfigurasi bucket untuk notifikasi (topik SNS atau antrean SQS)](ways-to-add-notification-config-to-bucket.md). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "Example SNS topic policy", "Effect": "Allow", "Principal": { "Service": "s3.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:example-sns-topic", "Condition": { "ArnEquals": { "aws:SourceArn": "arn:aws:s3:::amzn-s3-demo-bucket" }, "StringEquals": { "aws:SourceAccount": "bucket-owner-123456789012" } } } ] } ``` ------ ### Kebijakan IAM untuk antrean SQS tujuan Berikut ini adalah contoh kebijakan IAM yang Anda lampirkan ke antrean SQS tujuan. Untuk petunjuk tentang cara menggunakan kebijakan ini untuk menyiapkan antrean Amazon SQS tujuan untuk pemberitahuan peristiwa, lihat [Panduan: Mengonfigurasi bucket untuk notifikasi (topik SNS atau antrean SQS)](ways-to-add-notification-config-to-bucket.md). Untuk menggunakan kebijakan ini, Anda harus memperbarui ARN antrian Amazon SQS, nama bucket, dan ID pemilik bucket. Akun AWS ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "s3.amazonaws.com" }, "Action": [ "SQS:SendMessage" ], "Resource": "arn:aws:sqs:us-east-1:111122223333:queue-name", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket" }, "StringEquals": { "aws:SourceAccount": "bucket-owner-123456789012" } } } ] } ``` ------ Untuk kebijakan Amazon SNS dan Amazon SQS IAM, Anda dapat menentukan `StringLike` kondisi dalam kebijakan, bukan kondisi `ArnLike`. Bila `ArnLike` digunakan, partisi, layanan, ID akun, tipe sumber daya, dan sebagian ID sumber daya parsi dari ARN harus sama persis dengan ARN dalam konteks permintaan. Hanya wilayah dan jalur sumber daya yang memungkinkan pencocokan sebagian. Ketika `StringLike` digunakan sebagai gantinya`ArnLike`, pencocokan mengabaikan struktur ARN dan memungkinkan pencocokan paral, terlepas dari bagian yang digantikan oleh karakter wildcard. Untuk informasi selengkapnya, lihat [Elemen Kebijakan IAM JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) dalam *Panduan Pengguna IAM*. ``` "Condition": {        "StringLike": { "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket" } } ``` ### AWS KMS kebijakan kunci Jika antrean SQS atau topik SNS dienkripsi dengan kunci yang dikelola pelanggan AWS Key Management Service (AWS KMS), Anda harus memberikan izin utama layanan Amazon S3 untuk bekerja dengan topik atau antrian terenkripsi. Untuk memberikan izin pengguna utama layanan Amazon S3, tambahkan pernyataan berikut ke kebijakan kunci untuk CMK. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "s3.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` ------ Untuk informasi selengkapnya tentang kebijakan AWS KMS utama, lihat [Menggunakan kebijakan utama AWS KMS di](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) *Panduan AWS Key Management Service Pengembang*. Untuk informasi selengkapnya tentang penggunaan enkripsi sisi server dengan Amazon AWS KMS SQS dan Amazon SNS, lihat berikut ini: + [Pengelolaan kunci](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html) di *Panduan Pengembang Layanan Notifikasi Sederhana Amazon*. + [Pengelolaan kunci](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-key-management.html) di *Panduan Pengembang Layanan Antrean Sederhana Amazon*. + [Mengenkripsi pesan yang diterbitkan untuk Amazon SNS dengan AWS KMS](https://aws.amazon.com/blogs/compute/encrypting-messages-published-to-amazon-sns-with-aws-kms/) dalam *Blog Komputasi AWS *. # Mengaktifkan dan mengonfigurasi notifikasi peristiwa menggunakan konsol Amazon S3 Anda dapat mengaktifkan peristiwa bucket tujuan umum Amazon S3 tertentu untuk mengirim pesan notifikasi ke tujuan kapan pun peristiwa tersebut terjadi. Bagian ini menjelaskan cara menggunakan konsol Amazon S3 untuk mengaktifkan pemberitahuan peristiwa. Untuk informasi tentang cara menggunakan notifikasi acara dengan AWS SDKs dan Amazon S3 REST APIs, lihat. [Mengonfigurasi notifikasi peristiwa secara terprogram](how-to-enable-disable-notification-intro.md#event-notification-configuration) **Prasyarat**: Sebelum dapat mengaktifkan notifikasi peristiwa untuk bucket Anda, Anda harus menyiapkan salah satu jenis tujuan dan kemudian mengonfigurasi izin. Untuk informasi selengkapnya, lihat [Tujuan peristiwa yang didukung](notification-how-to-event-types-and-destinations.md#supported-notification-destinations) dan [memberikan izin untuk memublikasikan pesan pemberitahuan peristiwa ke tujuan](grant-destinations-permissions-to-s3.md). **catatan** Antrean Amazon Simple Queue Service FIFO (First-In-First-Out) tidak didukung sebagai tujuan pemberitahuan peristiwa Amazon S3. Untuk mengirim pemberitahuan untuk acara Amazon S3 ke antrian FIFO Amazon SQS, Anda dapat menggunakan Amazon. EventBridge Untuk informasi selengkapnya, lihat [Mengaktifkan Amazon EventBridge](enable-event-notifications-eventbridge.md). **Topics** + [ ## Mengaktifkan notifikasi Amazon SNS, Amazon SQS, atau Lambda menggunakan konsol Amazon S3 ](#enable-event-notifications-sns-sqs-lam) ## Mengaktifkan notifikasi Amazon SNS, Amazon SQS, atau Lambda menggunakan konsol Amazon S3 **Untuk mengaktifkan dan mengonfigurasi pemberitahuan peristiwa untuk bucket 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. Navigasikan ke **Pemberitahuan Acara** dan pilih **Buat pemberitahuan peristiwa**. 1. Di bagian **Konfigurasi umum**, sebutkan nama peristiwa deskriptif untuk pemberitahuan peristiwa Anda. Atau, Anda juga dapat menentukan prefiks dan sufiks untuk membatasi pemberitahuan ke objek dengan kunci yang berakhir dalam karakter yang ditentukan. 1. Masukkan deskripsi untuk **Nama peristiwa**. Jika Anda tidak memasukkan nama, pengidentifikasi unik global (GUID) akan dibuat dan digunakan untuk nama. 1. (Opsional) Untuk memfilter pemberitahuan peristiwa dengan prefiks, masukkan **Prefiks**. Misalnya, Anda dapat menyiapkan filter prefiks sehingga Anda menerima pemberitahuan hanya ketika file ditambahkan ke folder tertentu (misalnya, `images/`). 1. (Opsional) Untuk memfilter pemberitahuan peristiwa dengan sufiks, masukkan **Sufiks**. Untuk informasi selengkapnya, lihat [Mengonfigurasi notifikasi peristiwa dengan filter nama kunci objek](notification-how-to-filtering.md). 1. Di bagian **Jenis peristiwa**, pilih satu atau beberapa jenis peristiwa yang ingin Anda terima pemberitahuannya. Untuk daftar jenis peristiwa berbeda, lihat [Jenis event yang didukung untuk SQS, SNS, dan Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types). 1. Di bagian **Tujuan**, pilih tujuan pemberitahuan peristiwa. **catatan** Sebelum Anda dapat menerbitkan pemberitahuan peristiwa, Anda harus memberikan izin yang diperlukan kepada pengguna utama Amazon S3 untuk memanggil API terkait. Ini agar dapat menerbitkan pemberitahuan ke fungsi Lambda, topik SNS, atau antrean SQS. 1. Pilih jenis tujuan: **Fungsi Lambda**, **Topik SNS**, atau **Antrean SQS**. 1. Setelah memilih jenis tujuan Anda, pilih fungsi, topik, atau antrean dari daftar. 1. Atau, jika Anda ingin menentukan Amazon Resource Name (ARN), pilih **Maemasukkan ARN** dan memasukkan ARN. Untuk informasi selengkapnya, lihat [Tujuan peristiwa yang didukung](notification-how-to-event-types-and-destinations.md#supported-notification-destinations). 1. Memilih **Simpan perubahan**, dan Amazon S3 mengirimkan pesan pengujian ke destinasi notifikasi peristiwa. ## Mengonfigurasi notifikasi peristiwa secara terprogram Secara default, notifikasi tidak diaktifkan untuk jenis peristiwa apa pun. Oleh karena itu, awalnya sub-sumber daya *notifikasi* menyimpan konfigurasi kosong. ``` ``` Untuk mengaktifkan pemberitahuan tentang peristiwa jenis tertentu, Anda mengganti XML dengan konfigurasi yang sesuai yang mengidentifikasi jenis peristiwa yang Anda ingin Amazon S3 untuk terbitkan dan tujuan di mana Anda ingin peristiwa tersebut diterbitkan. Untuk setiap tujuan, Anda menambahkan konfigurasi XML terkait. **Untuk mempublikasikan pesan peristiwa ke antrean SQS** Untuk mengatur antrean SQS sebagai tujuan notifikasi untuk satu atau beberapa jenis peristiwa, Anda menambahkan `QueueConfiguration`. ``` optional-id-string sqs-queue-arn event-type event-type ... ... ``` **Untuk memublikasikan pesan uji ke topik SNS** Untuk menetapkan topik SNS sebagai tujuan notifikasi untuk jenis peristiwa tertentu, Anda menambahkan `TopicConfiguration`. ``` optional-id-string sns-topic-arn event-type event-type ... ... ``` **Untuk memanggil AWS Lambda fungsi dan memberikan pesan acara sebagai argumen** Untuk mengatur fungsi Lambda sebagai tujuan notifikasi untuk jenis peristiwa tertentu, Anda menambahkan `CloudFunctionConfiguration`. ```    optional-id-string    cloud-function-arn         event-type       event-type       ...   ... ``` **Untuk menghapus semua notifikasi yang dikonfigurasi pada bucket** Untuk menghapus semua notifikasi yang dikonfigurasi di bucket, simpan elemen `` kosong dalam sub-sumber daya *notifikasi*. Saat Amazon S3 mendeteksi peristiwa dengan jenis tertentu, itu menerbitkan pesan dengan informasi peristiwa. Untuk informasi selengkapnya, lihat [Struktur pesan peristiwa](notification-content-structure.md). Untuk informasi lebih lanjut tentang mengonfigurasi notifikasi Peristiwa, lihat topik berikut: + [Panduan: Mengonfigurasi bucket untuk notifikasi (topik SNS atau antrean SQS)](ways-to-add-notification-config-to-bucket.md). + [Mengonfigurasi notifikasi peristiwa dengan filter nama kunci objek](notification-how-to-filtering.md) # Panduan: Mengonfigurasi bucket untuk notifikasi (topik SNS atau antrean SQS) Anda dapat menerima notifikasi Amazon S3 menggunakan Amazon Simple Notification Service (Amazon SNS); atau Amazon Simple Queue Service (Amazon SQS). Dalam panduan selanjutnya, Anda akan menambahkan konfigurasi notifikasi ke bucket Anda menggunakan topik Amazon SNS dan antrean Amazon SQS. **catatan** Antrean Amazon Simple Queue Service FIFO (First-In-First-Out) tidak didukung sebagai tujuan pemberitahuan peristiwa Amazon S3. Untuk mengirim pemberitahuan untuk acara Amazon S3 ke antrian FIFO Amazon SQS, Anda dapat menggunakan Amazon. EventBridge Untuk informasi selengkapnya, lihat [Mengaktifkan Amazon EventBridge](enable-event-notifications-eventbridge.md). **Topics** + [ ## Ringkasan panduan ](#notification-walkthrough-summary) + [ ## Langkah 1: Buat antrean Amazon SQS ](#step1-create-sqs-queue-for-notification) + [ ## Langkah 2: Buat Topik Amazon SNS ](#step1-create-sns-topic-for-notification) + [ ## Langkah 3: Menambahkan konfigurasi notifikasi ke bucket Anda ](#step2-enable-notification) + [ ## Langkah 4: Menguji pengaturan ](#notification-walkthrough-1-test) ## Ringkasan panduan Panduan ini membantu Anda melakukan hal berikut ini: + Terbitkan peristiwa dari jenis `s3:ObjectCreated:*` ke antrean Amazon SQS. + Terbitkan peristiwa dari jenis `s3:ReducedRedundancyLostObject` ke topik Amazon SNS. Untuk informasi tentang konfigurasi pemberitahuan, lihat [Menggunakan Amazon SQS, Amazon SNS, dan Lambda](how-to-enable-disable-notification-intro.md). Anda dapat melakukan semua langkah ini menggunakan konsol, tanpa menulis kode apa pun. Selain itu, contoh kode yang digunakan AWS SDKs untuk Java dan .NET juga disediakan untuk membantu Anda menambahkan konfigurasi notifikasi secara terprogram. Prosedur ini mencakup langkah-langkah berikut: 1. Membuat antrean Amazon SQS. Menggunakan konsol Amazon SQS, buat antrean SQS. Anda dapat mengakses pesan apa pun yang dikirimkan Amazon S3 ke antrean secara terprogram. Namun, untuk panduan ini, Anda memverifikasi pesan pemberitahuan di konsol. Anda melampirkan kebijakan akses ke antrean untuk memberikan izin kepada Amazon S3 untuk memposting pesan. 1. Buat topik Amazon SNS. Dengan konsol Amazon SNS, buat topik SNS dan berlangganan ke topik tersebut. Dengan begitu, setiap peristiwa yang diposting ke sana dikirimkan kepada Anda. Anda menentukan email sebagai protokol komunikasi. Setelah Anda membuat topik, Amazon SNS mengirim email. Anda menggunakan tautan dalam email untuk mengonfirmasi langganan topik. Anda melampirkan kebijakan akses ke topik untuk memberikan izin kepada Amazon S3 untuk memposting pesan. 1. Tambahkan konfigurasi pemberitahuan ke bucket. ## Langkah 1: Buat antrean Amazon SQS Ikuti langkah-langkah untuk membuat dan berlangganan antrean Amazon Simple Queue Service (Amazon SQS). 1. Menggunakan konsol Amazon SQS, buat antrean. Untuk instruksi, lihat [Memulai dengan Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-getting-started.html) dalam *Panduan Pengembang Amazon Simple Queue Service*. 1. Ganti kebijakan akses yang terlampir pada antrean dengan kebijakan berikut. 1. Di konsol Amazon SQS, dalam daftar Antrian, pilih **nama antrean**. 1. Pada tab **Kebijakan akses**, pilih **Edit**. 1. Ganti kebijakan akses yang terlampir ke antrean. Di dalamnya, berikan ARN Amazon SQS, nama bucket sumber, dan ID akun pemilik bucket. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "s3.amazonaws.com" }, "Action": [ "SQS:SendMessage" ], "Resource": "arn:aws:sqs:us-west-2:111122223333:s3-notification-queue", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:s3:*:*:awsexamplebucket1" }, "StringEquals": { "aws:SourceAccount": "bucket-owner-123456789012" } } } ] } ``` ------ 1. Pilih **Simpan**. 1. (Opsional) Jika antrean Amazon SQS atau topik Amazon SNS diaktifkan dengan enkripsi sisi server dengan AWS Key Management Service (AWS KMS), tambahkan kebijakan berikut ke kunci terkelola pelanggan enkripsi simetris terkait. Anda harus menambahkan kebijakan ke CMK karena Anda tidak dapat memodifikasi kunci AWS terkelola untuk Amazon SQS atau Amazon SNS. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "s3.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` ------ Untuk informasi selengkapnya tentang penggunaan SSE untuk Amazon SQS dan Amazon SNS AWS KMS with, lihat berikut ini: + [Pengelolaan kunci](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html) di *Panduan Pengembang Layanan Notifikasi Sederhana Amazon*. + [Pengelolaan kunci](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-key-management.html) di *Panduan Pengembang Layanan Antrean Sederhana Amazon*. 1. Perhatikan antrean ARN. Antrean SQS yang Anda buat adalah sumber daya lain di Akun AWS Anda. Amazon Resource Name (ARN) yang unik. Anda membutuhkan ARN ini di langkah berikutnya. ARN memiliki format berikut: ``` arn:aws:sqs:aws-region:account-id:queue-name ``` ## Langkah 2: Buat Topik Amazon SNS Ikuti langkah-langkah untuk membuat dan berlangganan topik Amazon SNS. 1. Menggunakan konsol Amazon SNS membuat topik. Untuk instruksi, lihat [Membuat topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) dalam *Panduan Pengembang Amazon Simple Notification Service*. 1. Berlangganan topik tersebut. Untuk latihan ini, gunakan email sebagai protokol komunikasi. Untuk instruksi, lihat [Berlangganan topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-subscribe-endpoint-to-topic.html) dalam *Panduan Pengembang Amazon Simple Notification Service*. Anda mendapatkan email yang meminta Anda untuk mengonfirmasi langganan Anda ke topik tersebut. Konfirmasi langganan. 1. Ganti kebijakan akses yang terlampir pada topik dengan kebijakan berikut. Di dalamnya, berikan ARN topik SNS, nama bucket, dan ID akun pemilik bucket. 1. Perhatikan topik ARN. Topik SNS yang Anda buat adalah sumber daya lain di Anda Akun AWS, dan memiliki ARN yang unik. Anda akan membutuhkan ARN ini di langkah berikutnya. ARN akan memiliki format berikut: ``` arn:aws:sns:aws-region:account-id:topic-name ``` ## Langkah 3: Menambahkan konfigurasi notifikasi ke bucket Anda Anda dapat mengaktifkan notifikasi bucket baik dengan menggunakan konsol Amazon S3 atau secara terprogram dengan menggunakan. AWS SDKs Memilih salah satu opsi untuk mengonfigurasi notifikasi pada bucket Anda. Bagian ini memberikan contoh kode menggunakan AWS SDKs untuk Java dan .NET. ### Opsi A: Mengaktifkan notifikasi pada bucket menggunakan konsol tersebut Menggunakan konsol Amazon S3, menambahkan konfigurasi notifikasi yang meminta Amazon S3 untuk melakukan hal berikut ini: + Terbitkan peristiwa **Semua objek membuat peristiwa** ke antrean Amazon SQS Anda. + Terbitkan peristiwa **Objek dalam RRS hilang** ketik topik Amazon SNS Anda. Setelah Anda menyimpan konfigurasi pemberitahuan, Amazon S3 memposting pesan uji, yang Anda dapatkan melalui email. Untuk petunjuk, lihat [Mengaktifkan dan mengonfigurasi notifikasi peristiwa menggunakan konsol Amazon S3](enable-event-notifications.md). ### Opsi B: Aktifkan notifikasi pada ember menggunakan AWS SDKs ------ #### [ .NET ] Contoh kode C\$1 berikut memberikan daftar kode lengkap yang menambahkan konfigurasi pemberitahuan ke bucket. Anda harus memperbarui kode dan memberikan nama bucket dan ARN topik SNS. Untuk informasi tentang menyiapkan dan menjalankan contoh kode, lihat [Memulai SDK for .NET di AWSAWS SDK for](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) .NET *Developer Guide*. ``` using Amazon; using Amazon.S3; using Amazon.S3.Model; using System; using System.Collections.Generic; using System.Threading.Tasks; namespace Amazon.DocSamples.S3 { class EnableNotificationsTest { private const string bucketName = "*** bucket name ***"; private const string snsTopic = "*** SNS topic ARN ***"; private const string sqsQueue = "*** SQS topic ARN ***"; // Specify your bucket region (an example region is shown). private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2; private static IAmazonS3 client; public static void Main() { client = new AmazonS3Client(bucketRegion); EnableNotificationAsync().Wait(); } static async Task EnableNotificationAsync() { try { PutBucketNotificationRequest request = new PutBucketNotificationRequest { BucketName = bucketName }; TopicConfiguration c = new TopicConfiguration { Events = new List { EventType.ObjectCreatedCopy }, Topic = snsTopic }; request.TopicConfigurations = new List(); request.TopicConfigurations.Add(c); request.QueueConfigurations = new List(); request.QueueConfigurations.Add(new QueueConfiguration() { Events = new List { EventType.ObjectCreatedPut }, Queue = sqsQueue }); PutBucketNotificationResponse response = await client.PutBucketNotificationAsync(request); } catch (AmazonS3Exception e) { Console.WriteLine("Error encountered on server. Message:'{0}' ", e.Message); } catch (Exception e) { Console.WriteLine("Unknown error encountered on server. Message:'{0}' ", e.Message); } } } } ``` ------ #### [ Java ] Untuk contoh cara mengonfigurasi notifikasi bucket dengan AWS SDK for Java, [lihat Memproses pemberitahuan peristiwa S3](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ProcessS3EventNotification_section.html) di Referensi API *Amazon S3*. ------ ## Langkah 4: Menguji pengaturan Sekarang Anda dapat menguji pengaturan dengan mengunggah objek ke bucket Anda dan memverifikasi pemberitahuan peristiwa di konsol Amazon SQS. Untuk instruksi, lihat [Menerima Pesan](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-getting-started.htmlReceiveMessage.html) dalam *Bagian "Memulai" Panduan Pengembang Amazon Simple Queue Service*. # Mengonfigurasi notifikasi peristiwa dengan filter nama kunci objek Ketika mengkonfigurasi notifikasi peristiwa Amazon S3, Anda harus menentukan mana jenis peristiwa Amazon S3 yang didukung yang menyebabkan Amazon S3 untuk mengirim notifikasi. Jika jenis peristiwa yang Anda tidak tentukan terjadi di bucket S3 Anda, Amazon S3 tidak mengirim notifikasi. Anda dapat mengonfigurasi pemberitahuan untuk difilter dengan prefiks dan sufiks nama kunci objek. Misalnya, Anda dapat menyiapkan konfigurasi di mana Anda akan dikirimi pemberitahuan hanya ketika file gambar dengan ekstensi nama file "`.jpg`" file ditambahkan ke bucket. Atau, Anda dapat memiliki konfigurasi yang mengirimkan pemberitahuan ke topik Amazon SNS ketika objek dengan awalan `images/` "" ditambahkan ke ember, sambil memiliki pemberitahuan untuk objek dengan awalan `logs/` "" di ember yang sama dikirim ke suatu fungsi. AWS Lambda **catatan** Karakter wildcard (“\$1”) tidak dapat digunakan dalam filter sebagai prefiks atau sufiks. Jika prefiks atau sufiks Anda mengandung spasi, Anda harus menggantinya dengan karakter "\$1". Jika Anda menggunakan karakter kustom apa pun dalam nilai prefiks atau sufiks, Anda harus memasukkan mereka ke dalam [Format yang dikodekan URL (persen-dikodekan)](https://en.wikipedia.org/wiki/Percent-encoding). Untuk daftar lengkap karakter kustom yang harus dikonversi ke format yang dikodekan URL saat digunakan dalam prefiks atau sufiks untuk pemberitahuan peristiwa, lihat. [Karakter aman](object-keys.md#object-key-guidelines-safe-characters) Anda dapat mengatur konfigurasi notifikasi yang menggunakan filter nama kunci objek di konsol Amazon S3. Anda dapat melakukannya dengan menggunakan Amazon S3 APIs melalui AWS SDKs atau REST APIs secara langsung. Untuk informasi tentang penggunaan UI konsol tersebut untuk mengatur konfigurasi notifikasi pada bucket, lihat [Mengaktifkan dan mengonfigurasi notifikasi peristiwa menggunakan konsol Amazon S3](enable-event-notifications.md). Amazon S3 menyimpan konfigurasi pemberitahuan sebagai XML di sub-sumber daya *notifikasi* yang terkait dengan bucket, seperti yang telah dijelaskan di [Menggunakan Amazon SQS, Amazon SNS, dan Lambda](how-to-enable-disable-notification-intro.md). Anda menggunakan struktur XML `Filter` untuk menentukan aturan notifikasi yang akan difilter dengan prefiks atau sufiks nama kunci objek. Untuk informasi tentang struktur XML `Filter`, lihat [Notifikasi PUT Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTnotification.html) di *Referensi API Amazon Simple Storage Service*. Konfigurasi pemberitahuan yang menggunakan `Filter` tidak dapat menentukan aturan pemfilteran dengan prefiks yang tumpang tindih, sufiks yang tumpang tindih, atau prefiks dan sufiks yang tumpang tindih. Bagian berikut memiliki contoh konfigurasi pemberitahuan yang valid dengan pemfilteran nama kunci objek. Juga berisi contoh konfigurasi notifikasi yang tidak valid karena prefiks dan sufiks tumpang tindih. **Topics** + [ ## Contoh konfigurasi pemberitahuan yang valid dengan pemfilteran nama kunci objek ](#notification-how-to-filtering-example-valid) + [ ## Contoh konfigurasi notifikasi dengan prefiks dan sufiks yang tidak valid saling tumpang tindih ](#notification-how-to-filtering-examples-invalid) ## Contoh konfigurasi pemberitahuan yang valid dengan pemfilteran nama kunci objek Konfigurasi notifikasi berikut berisi konfigurasi antrean yang mengidentifikasi antrean Amazon SQS untuk Amazon S3 untuk menerbitkan peristiwa ke jenis `s3:ObjectCreated:Put`. Peristiwa dipublikasikan kapan pun objek yang memiliki prefiks `images/` dan sufiks `jpg` di-PUT ke dalam bucket. ``` 1 prefix images/ suffix jpg arn:aws:sqs:us-west-2:444455556666:s3notificationqueue s3:ObjectCreated:Put ``` Konfigurasi pemberitahuan berikut memiliki beberapa prefiks yang tidak tumpang tindih. Konfigurasi tersebut menentukan bahwa notifikasi untuk permintaan PUT di folder `images/` masuk ke antrean A, sedangkan notifikasi untuk permintaan PUT di `logs/` masuk ke antrean B. ``` 1 prefix images/ arn:aws:sqs:us-west-2:444455556666:sqs-queue-A s3:ObjectCreated:Put 2 prefix logs/ arn:aws:sqs:us-west-2:444455556666:sqs-queue-B s3:ObjectCreated:Put ``` Konfigurasi notifikasi berikut memiliki beberapa sufiks yang tidak tumpang tindih. Konfigurasi mendefinisikan bahwa semua `.jpg` gambar yang baru ditambahkan ke bucket diproses oleh cloud-function-A Lambda, dan semua gambar yang baru `.png` ditambahkan diproses oleh. cloud-function-B Sufiks `.png` dan `.jpg` sufiks tidak tumpang tindih meskipun mereka memiliki huruf terakhir yang sama. Jika string tertentu dapat diakhiri dengan kedua sufiks, kedua sufiks dianggap sebagai tumpang tindih. String tidak dapat diakhiri dengan kedua `.png` dan `.jpg`, sehingga sufiks dalam konfigurasi contoh tidak tumpang tindih dengan sufiks. ``` 1 suffix .jpg arn:aws:lambda:us-west-2:444455556666:cloud-function-A s3:ObjectCreated:Put 2 suffix .png arn:aws:lambda:us-west-2:444455556666:cloud-function-B s3:ObjectCreated:Put ``` Konfigurasi notifikasi Anda yang menggunakan `Filter` tidak dapat menentukan aturan pemfilteran dengan prefiks yang tumpang tindih untuk jenis peristiwa yang sama. Mereka hanya bisa melakukannya, jika prefiks tumpang tindih yang digunakan dengan sufiks yang tidak tumpang tindih. Konfigurasi contoh berikut ini menunjukkan bagaimana objek yang dibuat dengan prefiks yang sama, tetapi sufiks yang tidak tumpang tindih dapat dikirim ke tujuan yang berbeda. ``` 1 prefix images suffix .jpg arn:aws:lambda:us-west-2:444455556666:cloud-function-A s3:ObjectCreated:Put 2 prefix images suffix .png arn:aws:lambda:us-west-2:444455556666:cloud-function-B s3:ObjectCreated:Put ``` ## Contoh konfigurasi notifikasi dengan prefiks dan sufiks yang tidak valid saling tumpang tindih Pada umumnya, konfigurasi pemberitahuan Anda yang menggunakan `Filter` tidak dapat menentukan aturan pemfilteran dengan prefiks yang tumpang tindih, sufiks yang tumpang tindih, atau kombinasi prefiks dan sufiks yang tumpang tindih untuk jenis peristiwa yang sama. Anda dapat memiliki prefiks yang tumpang tindih selama sufiks tidak tumpang tindih. Sebagai contoh, lihat [Mengonfigurasi notifikasi peristiwa dengan filter nama kunci objek](#notification-how-to-filtering). Anda dapat menggunakan filter nama kunci objek yang tumpang tindih dengan jenis peristiwa yang berbeda. Misalnya, Anda dapat membuat konfigurasi notifikasi yang menggunakan prefiks `image/` untuk jenis peristiwa `ObjectCreated:Put`, dan prefiks `image/` untuk jenis peristiwa `ObjectRemoved:*`. Anda mendapatkan kesalahan jika mencoba menyimpan konfigurasi pemberitahuan yang memiliki filter nama yang tumpang tindih yang tidak valid untuk jenis peristiwa yang sama saat menggunakan konsol atau API Amazon S3. Bagian ini menunjukkan contoh konfigurasi notifikasi yang tidak valid karena filter nama yang tumpang tindih. Aturan konfigurasi pemberitahuan apa pun yang ada diasumsikan memiliki prefiks dan sufiks default yang cocok dengan setiap prefiks dan sufiks lain. Konfigurasi pemberitahuan berikut tidak valid karena memiliki prefiks yang tumpang tindih. Secara kustom, prefiks root tumpang tindih dengan prefiks lainnya. Hal yang sama berlaku jika Anda menggunakan sufiks alih-alih prefiks dalam contoh ini. Akhiran root tumpang tindih dengan sufiks lainnya. ``` arn:aws:sns:us-west-2:444455556666:sns-notification-one s3:ObjectCreated:* arn:aws:sns:us-west-2:444455556666:sns-notification-two s3:ObjectCreated:* prefix images ``` Konfigurasi pemberitahuan berikut tidak valid karena memiliki sufiks yang tumpang tindih. Jika string tertentu dapat diakhiri dengan kedua sufiks, kedua sufiks dianggap sebagai tumpang tindih. Sebuah string dapat diakhiri dengan `jpg` dan `pg`. Jadi, sufiksnya tumpang tindih. Hal yang sama berlaku untuk prefiks. Jika string tertentu dapat dimulai dengan kedua prefiks, kedua prefiks dianggap tumpang tindih. ``` arn:aws:sns:us-west-2:444455556666:sns-topic-one s3:ObjectCreated:* suffix jpg arn:aws:sns:us-west-2:444455556666:sns-topic-two s3:ObjectCreated:Put suffix pg arn:aws:sns:us-west-2:444455556666:sns-topic-one s3:ObjectCreated:* prefix images suffix jpg arn:aws:sns:us-west-2:444455556666:sns-topic-two s3:ObjectCreated:Put suffix jpg ``` # Struktur pesan peristiwa Pesan pemberitahuan yang dikirimkan Amazon S3 untuk menerbitkan kegiatan ada dalam format JSON. Untuk ikhtisar umum dan petunjuk tentang mengonfigurasi pemberitahuan peristiwa, lihat [Notifikasi Peristiwa Amazon S3](EventNotifications.md). Contoh ini menunjukkan *versi 2.1* dari struktur JSON pemberitahuan acara. Amazon S3 menggunakan *versi 2.1*, *2.2*, dan *2.3* dari struktur peristiwa ini. Amazon S3 menggunakan versi 2.2 untuk pemberitahuan peristiwa replikasi lintas wilayah. Ini menggunakan versi 2.3 untuk Siklus Hidup S3, S3 Intelligent-Tiering, objek ACL, penandaan objek, dan peristiwa penghapusan restorasi objek. Versi ini berisi informasi tambahan kustom untuk operasi ini. Versi 2.2 dan 2.3 sebaliknya kompatibel dengan versi 2.1, yang saat ini digunakan Amazon S3 untuk semua jenis pemberitahuan peristiwa lainnya. ``` { "Records":[ { "eventVersion":"2.1", "eventSource":"aws:s3", "awsRegion":"us-west-2", "eventTime":"The time, in ISO-8601 format (for example, 1970-01-01T00:00:00.000Z) when Amazon S3 finished processing the request", "eventName":"The event type", "userIdentity":{ "principalId":"The unique ID of the IAM resource that caused the event" }, "requestParameters":{ "sourceIPAddress":"The IP address where the request came from" }, "responseElements":{ "x-amz-request-id":"The Amazon S3 generated request ID", "x-amz-id-2":"The Amazon S3 host that processed the request" }, "s3":{ "s3SchemaVersion":"1.0", "configurationId":"The ID found in the bucket notification configuration", "bucket":{ "name":"The name of the bucket, for example, amzn-s3-demo-bucket", "ownerIdentity":{ "principalId":"The Amazon retail customer ID of the bucket owner" }, "arn":"The bucket Amazon Resource Name (ARN)" }, "object":{ "key":"The object key name", "size":"The object size in bytes (as a number)", "eTag":"The object entity tag (ETag)", "versionId":"The object version if the bucket is versioning-enabled; null or not present if the bucket isn't versioning-enabled", "sequencer": "A string representation of a hexadecimal value used to determine event sequence; only used with PUT and DELETE requests" } }, "glacierEventData": { "restoreEventData": { "lifecycleRestorationExpiryTime": "The time, in ISO-8601 format (for example, 1970-01-01T00:00:00.000Z), when the temporary copy of the restored object expires", "lifecycleRestoreStorageClass": "The source storage class for restored objects" } } } ] } ``` Perhatikan hal berikut tentang struktur pesan peristiwa: + Nilai kunci `eventVersion` mengandung versi besar dan kecil, dalam bentuk `major`.`minor`. 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 ditingkatkan jika Amazon S3 menambahkan bidang baru ke struktur peristiwa. Hal ini dapat terjadi jika informasi baru diberikan untuk beberapa atau semua peristiwa yang ada. Ini mungkin juga terjadi jika informasi baru disediakan hanya untuk jenis acara yang baru diperkenalkan. Agar tetap kompatibel dengan versi minor baru dari struktur acara, kami menyarankan agar aplikasi Anda mengabaikan bidang baru. Jika jenis acara baru diperkenalkan, tetapi struktur acara dinyatakan tidak dimodifikasi, versi acara tidak berubah. 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 ada, kami juga merekomendasikan melakukan perbandingan greater-than-or-equal -to pada versi minor. + Nilai `eventName` kunci mereferensikan daftar [jenis pemberitahuan acara](https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-event-types-and-destinations.html) tetapi tidak berisi `s3:` awalan. + Nilai `userIdentity` kunci mereferensikan ID unik dari sumber daya AWS Identity and Access Management (IAM) (pengguna, peran, grup, dan sebagainya) yang menyebabkan peristiwa tersebut. [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html##identifiers-unique-ids](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html##identifiers-unique-ids) + Nilai `responseElements` kunci berguna jika Anda ingin melacak permintaan dengan menindaklanjuti AWS Dukungan. Baik `x-amz-request-id` maupun `x-amz-id-2` membantu Amazon S3 menelusuri permintaan individu. Nilai-nilai ini sama dengan nilai yang dikembalikan Amazon S3 sebagai respons terhadap permintaan yang memulai peristiwa. Oleh karena itu, Anda dapat menggunakan nilai-nilai ini untuk mencocokkan acara dengan permintaan. + Nilai `s3` kunci memberikan informasi tentang bucket dan objek yang terlibat dalam acara tersebut. Nilai nama kunci objek dienkode URL. Misalnya, `red flower.jpg` menjadi `red+flower.jpg`. (Amazon S3 mengembalikan "`application/x-www-form-urlencoded`" sebagai jenis konten dalam respons.) Nilai `ownerIdentity` kunci sesuai dengan ID pelanggan ritel Amazon (Amazon.com) dari pemilik bucket. Nilai ID ini tidak lagi digunakan dan dipertahankan hanya untuk kompatibilitas mundur. + Nilai `sequencer` kunci menyediakan cara untuk menentukan urutan peristiwa. Pemberitahuan peristiwa tidak dijamin akan tiba dalam urutan yang sama dengan peristiwa yang terjadi. Namun, pemberitahuan dari peristiwa yang membuat objek (`PUT`permintaan) dan menghapus objek berisi file`sequencer`. Anda dapat menggunakan nilai ini untuk menentukan urutan peristiwa untuk kunci objek yang diberikan. Jika Anda membandingkan string `sequencer` dari dua notifikasi peristiwa pada kunci objek yang sama, pemberitahuan peristiwa dengan nilai heksadesimal `sequencer` yang lebih besar adalah peristiwa yang terjadi kemudian. Jika Anda menggunakan notifikasi peristiwa untuk memelihara basis data atau indeks terpisah dari objek Amazon S3, kami sarankan Anda membandingkan dan menyimpan nilai `sequencer` saat Anda memproses setiap pemberitahuan peristiwa. Perhatikan hal-hal berikut: + Anda tidak dapat menggunakan nilai `sequencer` kunci untuk menentukan urutan peristiwa pada kunci objek yang berbeda. + `sequencer`Senar bisa memiliki panjang yang berbeda. Jadi, untuk membandingkan nilai-nilai ini, pertama-tama kiri-pad nilai yang lebih pendek dengan nol, dan kemudian lakukan perbandingan leksikografis. + Nilai `glacierEventData` kunci hanya terlihat untuk `s3:ObjectRestore:Completed` acara. + Nilai `restoreEventData` kunci berisi atribut yang terkait dengan permintaan pemulihan Anda. + Nilai `replicationEventData` kunci hanya terlihat untuk peristiwa replikasi. + Nilai `intelligentTieringEventData` kunci hanya terlihat untuk acara S3 Intelligent-Tiering. + Nilai `lifecycleEventData` kunci hanya terlihat untuk peristiwa transisi Siklus Hidup S3. ## Contoh pesan Berikut ini adalah contoh dari pesan notifikasi peristiwa Amazon S3. **Olahpesan pengujian Amazon S3** Setelah mengonfigurasi notifikasi peristiwa di bucket, Amazon S3 mengirimkan pesan pengujian berikut. ``` 1. { 2. "Service":"Amazon S3", 3. "Event":"s3:TestEvent", 4. "Time":"2014-10-13T15:57:02.089Z", 5. "Bucket":"amzn-s3-demo-bucket", 6. "RequestId":"5582815E1AEA5ADF", 7. "HostId":"8cLeGAmw098X5cv4Zkwcmo8vvZa3eH3eKxsPzbB9wrR+YstdA6Knx4Ip8EXAMPLE" 8. } ``` **catatan** `s3:TestEvent`Pesan menggunakan format yang berbeda dari notifikasi acara S3 biasa. Tidak seperti pemberitahuan acara lain yang menggunakan struktur `Records` array yang ditunjukkan sebelumnya, acara pengujian menggunakan format yang disederhanakan dengan bidang langsung. Saat menerapkan penanganan acara, pastikan kode Anda dapat membedakan antara dan menangani kedua format pesan dengan benar. **Contoh pesan saat objek dibuat menggunakan `PUT` permintaan** Berikut ini adalah contoh pesan yang dikirimkan Amazon S3 untuk menerbitkan peristiwa `s3:ObjectCreated:Put`. ``` 1. { 2. "Records":[ 3. { 4. "eventVersion":"2.1", 5. "eventSource":"aws:s3", 6. "awsRegion":"us-west-2", 7. "eventTime":"1970-01-01T00:00:00.000Z", 8. "eventName":"ObjectCreated:Put", 9. "userIdentity":{ 10. "principalId":"AIDAJDPLRKLG7UEXAMPLE" 11. }, 12. "requestParameters":{ 13. "sourceIPAddress":"172.16.0.1" 14. }, 15. "responseElements":{ 16. "x-amz-request-id":"C3D13FE58DE4C810", 17. "x-amz-id-2":"FMyUVURIY8/IgAtTv8xRjskZQpcIZ9KG4V5Wp6S7S/JRWeUWerMUE5JgHvANOjpD" 18. }, 19. "s3":{ 20. "s3SchemaVersion":"1.0", 21. "configurationId":"testConfigRule", 22. "bucket":{ 23. "name":"amzn-s3-demo-bucket", 24. "ownerIdentity":{ 25. "principalId":"A3NL1KOZZKExample" 26. }, 27. "arn":"arn:aws:s3:::amzn-s3-demo-bucket" 28. }, 29. "object":{ 30. "key":"HappyFace.jpg", 31. "size":1024, 32. "eTag":"d41d8cd98f00b204e9800998ecf8427e", 33. "versionId":"096fKKXTRTtl3on89fVO.nfljtsv6qko", 34. "sequencer":"0055AED6DCD90281E5" 35. } 36. } 37. } 38. ] 39. } ``` # 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 *.