全部产品
Search

搜索本产品

    ：Gunakan fitur notifikasi

    文档中心

    ：Gunakan fitur notifikasi

    更新时间：Jul 06, 2025

    Respon untuk permintaan pemrosesan asinkron hanya mencakup ID tugas pemrosesan. Untuk mendapatkan hasil dari tugas tersebut, Anda harus menambahkan parameter dalam permintaan untuk mengaktifkan notifikasi pesan.

    Catatan Penggunaan

    • Notifikasi pesan hanya dapat diaktifkan untuk permintaan pemrosesan asinkron.

    • Notifikasi pesan hanya mendukung model perpesanan berbasis topik dari Simple Message Queue (SMQ, sebelumnya MNS). Untuk informasi lebih lanjut, lihat Ikhtisar.

    Parameter

    Jika Anda menambahkan parameter notify ke permintaan, Anda harus menentukan opsi yang dijelaskan dalam tabel berikut.

    Parameter

    Diperlukan

    Deskripsi

    topic

    Ya

    Nama topik SMQ

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

    • Topik SMQ harus berupa string yang aman untuk URL dan dikodekan dalam Base64. Sebagai contoh, sebuah topik bernama test harus dikodekan sebagai dGVzdA==. Anda dapat menggunakan alat pengkodean watermark untuk melakukan proses pengkodean ini.

    Untuk informasi lebih lanjut, lihat Bagaimana cara melihat topik SMQ di konsol SMQ?.

    Gunakan API RESTful

    Jika bisnis Anda memerlukan tingkat penyesuaian yang tinggi, Anda dapat memulai permintaan pemrosesan asinkron dengan memanggil API RESTful. Dalam kasus ini, Anda harus mengembangkan kode secara manual di aplikasi Anda untuk menghitung tanda tangan.

    Saat Anda memanggil operasi PostObject, x-oss-async-process dilewatkan oleh badan permintaan. Anda dapat menambahkan parameter notify dalam permintaan untuk mengaktifkan notifikasi pesan. Notifikasi pesan hanya mendukung model perpesanan berbasis topik dari SMQ (sebelumnya MNS). Untuk informasi lebih lanjut tentang cara menggunakan SMQ, lihat Deskripsi versi Python SDK.

    Berikut adalah daftar contoh tugas asinkron yang memiliki notifikasi pesan yang diaktifkan.

    Aktifkan notifikasi pesan untuk file yang dikonversi menggunakan parameter pemrosesan

    Informasi tentang tugas konversi

    • Sebelum konversi:

      • Tipe file: DOCX

      • Nama file: example.docx

    • Setelah konversi:

      • Tipe file: PNG

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

    • Notifikasi pesan:

      Kirim hasil konversi ke topik SMQ bernama test-topic.

    Contoh permintaan

    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

// Konversikan example.docx dalam format DOCX menjadi gambar dalam format PNG, simpan gambar yang telah dikonversi ke oss://test-bucket/doc_images/, dan kirim hasilnya ke topik SMQ bernama test-topic.
x-oss-async-process=doc/convert,target_png,source_docx|sys/saveas,b_dGVzdC1idWNrZXQ,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw/notify,topic_dGVzdC10b3BpYw

    Menyimpan video yang ditranskode menggunakan parameter gaya ke bucket tertentu

    Informasi tentang tugas transkode

    • Sebelum transkode:

      • Format video: AVI

      • Nama video: example.avi

    • Setelah transkode:

      • Format video: MP4

      • Nama video: outobjprefix.mp4

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

    • Notifikasi pesan:

      Kirim hasil transkode 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
 
 // Transkode example.avi menggunakan gaya bernama examplestyle, simpan file yang telah ditranskode sebagai oss://outbucket/outobjprefix.mp4, dan kirim hasilnya ke topik SMQ bernama test-topic.
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYw

    Format pesan yang sesuai dengan x-oss-process terkait operasi

    Modul fungsi

    Operasi menggunakan perintah x-oss-process

    Format pesan

    Pemrosesan dokumen

    Konversi format dokumen

    Contoh pesan SMQ dari CreateOfficeConversionTask

    Pemrosesan media

    Contoh pesan SMQ dari CreateMediaConvertTask

    Pemrosesan file

    pointcloud/compress

    Contoh pesan SMQ dari CreateCompressPointCloudTask

    Pertanyaan Umum

    Bagaimana cara melihat topik SMQ di konsol SMQ?

    Untuk membantu Anda mengonfigurasi topik Simple Message Queue (sebelumnya MNS) terkait notifikasi acara OSS dengan lebih jelas, ikuti langkah-langkah berikut untuk menemukan dan mengonfirmasi nama topik SMQ di wilayah yang sama dengan OSS.

    Untuk membantu Anda mengonfigurasi topik Simple Message Queue (sebelumnya MNS) guna notifikasi acara OSS dengan lebih jelas, ikuti langkah-langkah berikut untuk menemukan dan mengonfirmasi nama topik SMQ di wilayah yang sama dengan OSS.

    1. Masuk ke Konsol SMQ.

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

    3. Di panel navigasi sisi kiri, klik Model Topik > Topik, lalu daftarkan semua topik yang ada di wilayah saat ini.

    4. Lihat daftar topik dan identifikasi nama topik yang sesuai dengan konfigurasi notifikasi acara OSS Anda.

      image

    Dengan mengikuti langkah-langkah di atas, Anda dapat menemukan dan mengonfigurasi nama topik SMQ di wilayah yang sama dengan OSS Anda dengan efisien, memastikan bahwa acara OSS dikirimkan dengan benar ke SMQ untuk diproses.