Simple Message Queue (formerly MNS)：Notifikasi Peristiwa OSS

Skema

• Jika memberi otorisasi kepada pengguna lain untuk melakukan operasi pada bucket OSS Anda dan ingin diberi tahu saat operasi tersebut terjadi, Anda dapat membuat aturan notifikasi peristiwa.

• Anda dapat menganalisis data berdasarkan notifikasi peristiwa, melihat jumlah kali suatu operasi dilakukan dalam periode waktu tertentu, serta menganalisis tren perkembangan bisnis baru-baru ini. Notifikasi peristiwa juga dapat diimpor ke layanan lain untuk analisis, seperti E-MapReduce (EMR).

• Anda dapat memantau metrik seperti QPS operasi yang dilakukan pada sumber daya OSS Anda berdasarkan notifikasi peristiwa.

Peristiwa

Format Pesan

Konten pesan notifikasi peristiwa OSS dikodekan dalam Base64. Setelah didekode, konten berada dalam format JSON. Contoh kode berikut menunjukkan contoh konten pesan yang didekode.

{
    "events":[
        {
            "eventName":"ObjectDownloaded:GetObject",
            "eventSource":"acs:oss",
            "eventTime":"2016-07-01T11:17:30.000Z",
            "eventVersion":"1.0",
            "oss":{
                "bucket":{
                    "arn":"acs:oss:cn-shenzhen:123456789098****:event-notification-test-shenzhen",
                    "name":"event-notification-test-shenzhen",
                    "ownerIdentity":"123456789098****"
                },
                "object":{
                    "deltaSize":0,
                    "eTag":"0CC175B9C0F1B6A831C399E26977****",
                    "key":"test",
                    "readFrom":0,
                    "readTo":1,
                    "size":1
                },
                "ossSchemaVersion":"1.0",
                "ruleId":"GetObjectRule"
            },
            "region":"cn-shenzhen",
            "requestParameters":{
                "sourceIPAddress":"140.205.XX.XX"
            },
            "responseElements":{
                "requestId":"5776514AF09A9E654242****"
            },
            "userIdentity":{
                "principalId":"123456789098****"
            },
            "xVars":{
                "x:callback-var1":"value1",
                "x:vallback-var2":"value2"
            }
        }
    ]
}

Tabel berikut menjelaskan parameter dalam konten pesan.

Catatan Penggunaan

• Diperlukan sekitar 10 menit agar aturan notifikasi peristiwa baru dapat berlaku.

• Sistem secara otomatis membuat topik untuk aturan notifikasi peristiwa, dan Anda mungkin dikenakan biaya untuk topik tersebut. Untuk informasi lebih lanjut, lihat Gambaran Penagihan.

• Anda dapat membuat atau menghapus aturan notifikasi peristiwa, namun tidak dapat memodifikasinya.

(Opsional) Langkah 1: Buat Antrian

Untuk berlangganan antrian guna menerima pesan dari klien hilir, Anda perlu membuat antrian. Anda juga dapat membuat langganan setelah aturan notifikasi peristiwa dibuat.

1. Masuk ke Konsol SMQ.

2. Di panel navigasi sisi kiri, pilih Queue Model > Queues.

3. Di bilah navigasi atas, pilih wilayah.

4. Pada halaman Queues, klik Create Queue.

5. Di panel Create Queue, konfigurasikan parameter berikut dan klik OK:

   • Name: Nama antrian.

   • Maximum Message Length: Panjang maksimum pesan yang dikirim ke antrian.

   • Long Polling Period: Durasi maksimum permintaan polling panjang dipegang setelah operasi ReceiveMessage dipanggil.

   • Visibility Timeout Period: Durasi pesan tetap dalam keadaan Tidak Aktif setelah diterima dari antrian.

   • Message Retention Period: Durasi maksimum pesan ada di antrian. Setelah periode retensi yang ditentukan, pesan akan dihapus terlepas dari apakah telah diterima.

   • Message Delay Period: Periode setelah semua pesan yang dikirim ke antrian dikonsumsi.

   • Enable Logging Feature: Menentukan apakah fitur pencatatan diaktifkan.

   Setelah antrian dibuat, antrian tersebut akan ditampilkan di halaman Queues.

(Opsional) Langkah 2: Buat Bucket

Jika bucket yang diinginkan sudah ada, lewati langkah ini.

1. Masuk ke Konsol OSS.

2. Di panel navigasi sisi kiri, klik Buckets.

3. Pada halaman Buckets, klik Create Bucket.

4. Di panel Create Bucket, konfigurasikan parameter berikut dan klik Create.

   • Nama Bucket: Nama bucket. Dalam contoh ini, event-notification-test digunakan.

   • Wilayah: Wilayah tempat bucket berada. Wilayah ini harus sama dengan wilayah tempat antrian berada.

   • Batasi Akses Publik: Menentukan apakah akses publik dibatasi. Dalam contoh ini, fitur ini dinonaktifkan.

   • ACL: Menentukan izin pada bucket. Dalam contoh ini, Public Read/Write dipilih.

     Catatan

     Gunakan nilai default parameter lainnya.

Langkah 3: Buat Aturan Notifikasi Peristiwa

Setelah aturan notifikasi peristiwa dibuat, SMQ secara otomatis membuat topik untuk aturan tersebut dan membuat langganan ke topik dengan titik akhir tertentu. Anda dapat melihat dan mengelola topik dan langganan di konsol SMQ.

1. Masuk ke Konsol SMQ.

2. Di panel navigasi sisi kiri, klik Event Notifications.

3. Di bilah navigasi atas, pilih wilayah.

4. Pada tab OSS halaman Event Notifications, klik Create Rule.

5. Di panel Create Rule - OSS, konfigurasikan parameter berikut dan klik OK.

   • Name: Masukkan nama untuk aturan.

   • Event Type: Pilih satu atau beberapa tipe acara.

   • Match Mode: Konfigurasikan mode pencocokan untuk aturan.

     Catatan

     Mode pencocokan termasuk Nama Lengkap, Awalan, Akhiran, dan Awalan & Akhiran. Dua mode pencocokan tidak boleh memiliki irisan. Sumber daya OSS mencakup bucket dan objek. Nama mereka dipisahkan dengan garis miring (/). Contoh: movie/hello.avi.

     • Nama Lengkap: movie/hello.avi.

     • Awalan:

       • movie/hello menunjukkan semua objek dengan awalan hello di bucket movie.

       • movie/ menunjukkan semua objek di bucket movie.

       • mov menunjukkan semua objek di bucket dengan awalan mov.

     • Akhiran: avi menunjukkan semua objek dengan akhiran .avi di semua bucket.

     • Awalan & Akhiran: Kombinasi movie/ awalan dan .avi akhiran menunjukkan semua objek dengan akhiran .avi di bucket movie.

   • Receiving Terminal: Pilih Queue dari daftar drop-down dan masukkan nama antrian yang Anda buat di Langkah 1.

Langkah 4: Unggah Objek

1. Masuk ke Konsol OSS.

2. Di panel navigasi sisi kiri, klik Buckets.

3. Pada halaman Buckets, klik nama bucket OSS yang ingin Anda kelola untuk masuk ke halaman Object Management.

4. Klik Upload Object di atas daftar objek. >

5. Pada halaman yang muncul, konfigurasikan parameter dan klik Upload Object. Untuk informasi lebih lanjut tentang parameter, lihat bagian Unggah Sederhana dari topik "Unggah Sederhana".

   Panel Daftar Tugas muncul. Di tab Tugas Unggah, status objek ditampilkan sebagai Terunggah.

Langkah 5: Terima Pesan

1. Masuk ke Konsol SMQ.

2. Di panel navigasi sisi kiri, pilih Queue Model > Queues.

3. Di bilah navigasi atas, pilih wilayah.

4. Pada halaman Queues, temukan antrian yang ingin Anda kelola dan pilih More > Send Messages di kolom Action.

5. Di bagian Receive Message halaman Quick Experience, klik Receive Message.

   Daftar pesan muncul di bagian Receive Message.

6. Dalam daftar pesan, temukan pesan yang ingin Anda lihat dan klik Details di kolom Actions. Di kotak dialog Message Details, lihat isi pesan.