All Products
Search

This Product

    Object Storage Service:Notifikasi pesan

    Document Center

    Object Storage Service:Notifikasi pesan

    Last Updated:Jun 22, 2026

    Permintaan pemrosesan asinkron hanya mengembalikan ID task. Untuk memperoleh hasil task setelah pemrosesan selesai, Anda harus menyertakan parameter notifikasi pesan dalam permintaan pemrosesan.

    Catatan penggunaan

    • Notifikasi pesan hanya didukung untuk pemrosesan asinkron.

    • Notifikasi pesan hanya mendukung topik untuk Simple Message Queue (SMQ). SMQ sebelumnya dikenal sebagai MNS. Untuk informasi selengkapnya tentang SMQ, lihat SMQ Quick Start.

    Deskripsi parameter

    Saat menggunakan parameter notify, sertakan opsi berikut:

    Parameter

    Wajib

    Deskripsi

    topic

    Ya

    Nama topik SMQ.

    • Topik SMQ harus berada di wilayah yang sama dengan bucket.

    • Nama topik harus diencode dalam Base64 URL-safe. Misalnya, topik bernama test harus dimasukkan sebagai dGVzdA==. Anda dapat menggunakan tool encoding Base64 URL untuk mengencode nama tersebut.

    Untuk mengetahui cara memperoleh nama topik SMQ, lihat Bagaimana cara melihat nama topik SMQ saya di Konsol?

    Menggunakan REST API

    Jika program Anda memerlukan tingkat kustomisasi yang tinggi, Anda dapat langsung mengirim permintaan REST API. Untuk melakukannya, Anda harus menulis kode secara manual untuk menghitung signature.

    Saat memanggil operasi PostObject untuk memproses objek, sertakan parameter x-oss-async-process dalam badan permintaan. Selanjutnya, tambahkan parameter notify ke permintaan agar menerima notifikasi mengenai hasil pemrosesan. Notifikasi hanya mendukung topik SMQ. Untuk informasi selengkapnya tentang penggunaan SMQ, lihat Panduan versi Python SDK.

    Bagian berikut memberikan contoh penerimaan notifikasi pesan SMQ dalam berbagai skenario.

    Menggunakan parameter pemrosesan untuk mengonversi dokumen dan menerima notifikasi pesan SMQ

    Informasi konversi

    • Sebelum konversi

      • Tipe file: DOCX

      • Nama file: example.docx

    • Setelah konversi

      • Tipe file: PNG

      • Jalur penyimpanan: oss://test-bucket/doc_images/

    • Notifikasi pesan

      Notifikasi hasil konversi dikirim ke topik SMQ bernama test-topic.

    Contoh pemrosesan

    POST /exmaple.docx?x-oss-async-process HTTP/1.1
Host: doc-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
// Mengonversi example.docx ke PNG, menyimpannya ke oss://test-bucket/doc_images/, dan mengirim notifikasi ke topik SMQ test-topic.
x-oss-async-process=doc/convert,target_png,source_docx|sys/saveas,b_dGVzdC1idWNrZXQ,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw/notify,topic_dGVzdC10b3BpYw

    Menggunakan parameter gaya untuk melakukan transkoding video dan menyimpannya ke bucket tertentu

    Informasi transkoding

    • Sebelum transkoding

      • Format video: AVI

      • Nama video: example.avi

    • Setelah transkoding

      • Format video: MP4

      • Nama video: outobjprefix.mp4

      • Jalur penyimpanan: oss://outbucket/outobjprefix.mp4

    • Notifikasi pesan

      Notifikasi hasil transkoding dikirim ke topik SMQ bernama test-topic.

    POST /exmaple.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 // Melakukan transkoding example.avi menggunakan gaya examplestyle, menyimpan output ke oss://outbucket/outobjprefix.mp4, dan mengirim notifikasi ke topik SMQ test-topic.
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYw

    Format pesan untuk operasi x-oss-process

    Modul fitur

    Operasi x-oss-process

    Format pesan

    Pemrosesan dokumen

    doc/convert

    Contoh pesan MNS untuk operasi CreateOfficeConversionTask

    ApsaraVideo Media Processing

    Contoh pesan MNS untuk operasi CreateMediaConvertTask

    Pemrosesan file

    pointcloud/compress

    Contoh pesan MNS untuk operasi CreateCompressPointCloudTask

    Pemrosesan gambar

    image/deblindwatermark

    Contoh pesan MNS untuk operasi CreateDecodeBlindWatermarkTask

    FAQ

    Bagaimana cara melihat nama topik SMQ saya di Konsol?

    Untuk mengonfigurasi topik Simple Message Queue (SMQ) guna notifikasi event OSS, Anda harus menggunakan topik yang berada di wilayah yang sama dengan bucket OSS Anda. Ikuti langkah-langkah berikut untuk menemukan nama topik SMQ. SMQ sebelumnya dikenal sebagai MNS.

    1. Masuk ke Konsol Simple Message Queue (SMQ), sebelumnya MNS.

    2. Di bilah navigasi atas Konsol, pastikan Anda memilih wilayah yang sama dengan bucket OSS Anda.

    3. Di panel navigasi kiri, klik Topic-based Model > Topic List untuk melihat semua topik yang telah dibuat di wilayah saat ini.

    4. Telusuri daftar topik untuk menemukan nama topik yang ingin Anda gunakan untuk konfigurasi notifikasi event OSS.

    Dengan mengikuti langkah-langkah ini, Anda dapat menemukan nama topik SMQ yang berada di wilayah yang sama dengan bucket OSS Anda. Penggunaan nama topik yang benar memastikan bahwa event OSS dikirim ke antrian pesan untuk diproses.