Permintaan pemrosesan asinkron hanya mengembalikan ID tugas. Untuk memperoleh hasil tugas setelah pemrosesan selesai, Anda harus menambahkan parameter notifikasi pesan ke 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 | Diperlukan | Deskripsi |
topic | Ya | Nama topik SMQ.
Untuk mempelajari 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, teruskan parameter x-oss-async-process dalam badan permintaan. Kemudian, tambahkan parameter notify ke permintaan agar menerima notifikasi pesan mengenai hasilnya. Notifikasi pesan 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 file DOCX example.docx menjadi citra PNG, menyimpan citra hasil konversi di jalur oss://test-bucket/doc_images/, dan mengirim notifikasi hasil konversi ke topik SMQ bernama test-topic.
x-oss-async-process=doc/convert,target_png,source_docx|sys/saveas,b_dGVzdC1idWNrZXQ,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw/notify,topic_dGVzdC10b3BpYwMenggunakan parameter gaya untuk melakukan transkoding video dan menyimpannya ke bucket tertentu
Informasi transkoding
Sebelum transkode:
Format video: AVI
Nama video:
example.avi
Setelah transkode:
Format video: MP4
Nama video:
outobjprefix.mp4Jalur 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
// Menggunakan gaya bernama examplestyle untuk melakukan transkoding file example.avi, menyimpan file hasil transkoding sebagai oss://outbucket/outobjprefix.mp4, dan mengirim notifikasi hasil transkoding ke topik SMQ bernama test-topic.
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYwFormat pesan untuk operasi x-oss-process
Modul fitur | Operasi x-oss-process | Format pesan |
Pemrosesan dokumen | ||
ApsaraVideo Media Processing | ||
Pemrosesan file | ||
Pemrosesan citra | 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.
Di bilah navigasi atas konsol, pastikan Anda memilih wilayah yang sama dengan bucket OSS Anda.
Di panel navigasi sebelah kiri, klik Topic-based Model > Topic List untuk melihat semua topik yang telah dibuat di wilayah tersebut.
Telusuri daftar topik untuk menemukan nama topik yang ingin Anda gunakan dalam konfigurasi notifikasi event OSS Anda.
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.