Menggunakan Amazon SQS, Amazon SNS, dan Lambda - Amazon Simple Storage Service
Mengonfigurasi notifikasi peristiwa secara terprogram

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

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.

  • 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).

    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.

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.

Topik

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.

<NotificationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
</NotificationConfiguration>

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.

<NotificationConfiguration>
  <QueueConfiguration>
    <Id>optional-id-string</Id>
    <Queue>sqs-queue-arn</Queue>
    <Event>event-type</Event>
    <Event>event-type</Event>
     ...
  </QueueConfiguration>
   ...
</NotificationConfiguration>
Untuk memublikasikan pesan uji ke topik SNS

Untuk menetapkan topik SNS sebagai tujuan notifikasi untuk jenis peristiwa tertentu, Anda menambahkan TopicConfiguration.

<NotificationConfiguration>
  <TopicConfiguration>
     <Id>optional-id-string</Id>
     <Topic>sns-topic-arn</Topic>
     <Event>event-type</Event>
     <Event>event-type</Event>
      ...
  </TopicConfiguration>
   ...
</NotificationConfiguration>
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.

<NotificationConfiguration>
  <CloudFunctionConfiguration>   
     <Id>optional-id-string</Id>   
     <CloudFunction>cloud-function-arn</CloudFunction>        
     <Event>event-type</Event>      
     <Event>event-type</Event>      
      ...  
  </CloudFunctionConfiguration>
   ...
</NotificationConfiguration>
Untuk menghapus semua notifikasi yang dikonfigurasi pada bucket

Untuk menghapus semua notifikasi yang dikonfigurasi di bucket, simpan elemen <NotificationConfiguration/> 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.

Untuk informasi lebih lanjut tentang mengonfigurasi notifikasi Peristiwa, lihat topik berikut: