Jenis dan tujuan pemberitahuan peristiwa - Amazon Simple Storage Service
Tujuan peristiwa yang didukungJenis acara yang didukung untukSQS,SNS, dan LambdaJenis acara yang didukung untuk Amazon EventBridgePemesanan acara dan duplikat acara

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

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.

Tujuan peristiwa yang didukung

Amazon S3 dapat mengirimkan pesan pemberitahuan peristiwa ke tujuan berikut.

  • Topik Layanan Pemberitahuan Sederhana Amazon (AmazonSNS)

  • Antrian Layanan Antrian Sederhana Amazon (AmazonSQS)

  • AWS Lambda

  • Amazon EventBridge

Namun, hanya satu jenis tujuan yang dapat ditentukan untuk setiap pemberitahuan peristiwa.

catatan

Anda harus memberikan izin Amazon S3 untuk mengirim pesan ke SNS topik Amazon atau antrian 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.

SNSTopik Amazon

Amazon SNS adalah layanan pesan push yang fleksibel dan dikelola sepenuhnya. Anda dapat menggunakan layanan ini untuk mendorong pesan ke perangkat seluler atau layanan terdistribusi. DenganSNS, Anda dapat mempublikasikan pesan sekali, dan mengirimkannya satu kali atau lebih. Saat ini, Standar hanya SNS diperbolehkan sebagai tujuan pemberitahuan acara S3, sedangkan tidak SNS FIFO diizinkan.

Amazon mengoordinasikan SNS dan mengelola pengiriman dan pengiriman pesan ke titik akhir atau klien berlangganan. Anda dapat menggunakan SNS konsol Amazon untuk membuat SNS topik Amazon tempat notifikasi Anda dapat dikirim.

Topiknya harus Wilayah AWS sama dengan bucket Amazon S3 Anda. Untuk petunjuk tentang cara membuat SNS topik Amazon, lihat Memulai Amazon SNS di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon dan Amazon SNS FAQ.

Sebelum Anda dapat menggunakan SNS topik Amazon yang Anda buat sebagai tujuan pemberitahuan acara, Anda memerlukan yang berikut ini:

  • Nama Sumber Daya Amazon (ARN) untuk SNS topik Amazon

  • Langganan SNS topik Amazon yang valid. Dengan itu, pelanggan topik diberitahu ketika pesan dipublikasikan ke SNS topik Amazon Anda.

SQSAntrian Amazon

Amazon SQS menawarkan antrian host yang andal dan dapat diskalakan untuk menyimpan pesan saat mereka melakukan perjalanan antar komputer. Anda dapat menggunakan Amazon SQS untuk mengirimkan volume data apa pun tanpa memerlukan layanan lain untuk selalu tersedia. Anda dapat menggunakan SQS konsol Amazon untuk membuat SQS antrean Amazon tempat notifikasi Anda dapat dikirim.

SQSAntrian Amazon harus Wilayah AWS sama dengan bucket Amazon S3 Anda. Untuk petunjuk tentang cara membuat SQS antrean Amazon, lihat Apa itu Layanan Antrian Sederhana Amazon dan Memulai Amazon SQS di Panduan Pengembang Layanan Antrian Sederhana Amazon.

Sebelum Anda dapat menggunakan SQS antrian Amazon sebagai tujuan pemberitahuan acara, Anda memerlukan yang berikut ini:

  • Nama Sumber Daya Amazon (ARN) untuk SQS antrian Amazon

catatan

Antrian 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 SQS FIFO antrian Amazon, Anda dapat menggunakan Amazon. EventBridge Untuk informasi selengkapnya, lihat Mengaktifkan Amazon EventBridge.

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 fungsi Lambda untuk mengatur fungsi Lambda sebagai tujuan pemberitahuan acara. ARN

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 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 AWS layanan atau HTTP titik akhir. Untuk informasi selengkapnya, lihat Apa yang ada EventBridge 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 acara yang didukung untukSQS,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

APIOperasi Amazon S3 sepertiPUT,POST, dan COPY dapat membuat objek. Dengan jenis acara ini, Anda dapat mengaktifkan notifikasi saat objek dibuat menggunakan API operasi tertentu. Atau, Anda dapat menggunakan jenis s3:ObjectCreated:* acara untuk meminta pemberitahuan terlepas dari API yang digunakan untuk membuat objek.

s3:ObjectCreated:CompleteMultipartUploadtermasuk objek yang dibuat menggunakan UploadPartCopyuntuk operasi Copy.

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. 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 acara pemberitahuan ini ketika Amazon S3 mendeteksi bahwa objek kelas RRS penyimpanan 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.

  • Jenis peristiwa s3:Replication:OperationFailedReplication memberi tahu Anda saat objek yang memenuhi syarat untuk replikasi gagal mereplikasi.

  • Jenis s3:Replication:OperationMissedThreshold peristiwa memberi tahu Anda ketika objek yang memenuhi syarat untuk replikasi yang menggunakan S3 RTC melebihi ambang batas 15 menit untuk replikasi.

  • Jenis s3:Replication:OperationReplicatedAfterThreshold acara memberi tahu Anda saat objek yang memenuhi syarat untuk replikasi yang menggunakan S3 RTC bereplikasi setelah ambang batas 15 menit.

  • Jenis s3:Replication:OperationNotTracked acara memberi tahu Anda saat objek yang memenuhi syarat untuk replikasi langsung (baik Same-Region Replication [SRR] atau Cross-Region Replication [CRR]) tidak lagi dilacak oleh metrik replikasi.

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 pemberitahuan saat tag objek ditambahkan atau dihapus dari objek.

Jenis s3:ObjectTagging:Put acara memberi tahu Anda saat tag berada PUT di objek atau tag yang ada diperbarui. Jenis peristiwa s3:ObjectTagging:Delete memberi tahu Anda saat tag dihapus dari objek.
s3:ObjectAcl:Put Anda menerima acara notifikasi ini saat ACL ada PUT di objek atau saat ACL ada diubah. Peristiwa tidak dihasilkan ketika permintaan tidak menghasilkan perubahan pada objekACL.

Jenis acara yang didukung untuk Amazon EventBridge

Untuk daftar jenis acara yang akan dikirimkan Amazon S3 ke Amazon EventBridge, lihat. Menggunakan EventBridge

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 kejadian duplikat atau di luar pesanan, lihat Mengelola pemesanan acara dan duplikat peristiwa dengan Pemberitahuan Acara Amazon S3 di AWS Blog Penyimpanan.