消息通知
異步處理請求返回時僅返回任務(wù)ID，您需要在處理請求內(nèi)添加消息通知參數(shù)，以在數(shù)據(jù)處理完成時獲取到數(shù)據(jù)處理任務(wù)的結(jié)果。
注意事項
僅異步處理支持消息通知。
消息通知僅支持輕量消息隊列SMQ（原MNS）主題。關(guān)于SMQ的更多信息，請參見SMQ快速入門。
參數(shù)說明
使用notify參數(shù)時，您需要攜帶以下選項：
參數(shù) | 是否必選 | 描述 |
topic | 是 | SMQ主題名稱，主題名稱需經(jīng)過URL安全的Base64編碼。具體操作，請參見水印編碼。 |
使用REST API
如果對程序自定義要求較高，您可以直接發(fā)起REST API請求。直接發(fā)起REST API請求需要手動編寫代碼計算簽名。
您可以在調(diào)用PostObject接口處理服務(wù)時，通過Body的方式傳遞x-oss-async-process，然后在處理請求中增加notify參數(shù)接收處理結(jié)果消息通知，消息通知僅支持SMQ主題，關(guān)于SMQ的使用，請參見Python SDK版本說明。
如下列舉各種接收SMQ消息通知場景的處理示例。
使用處理參數(shù)處理文檔轉(zhuǎn)換并接收SMQ消息通知
轉(zhuǎn)換信息
轉(zhuǎn)換前
文件類型：DOCX
文件名稱：
example.docx
轉(zhuǎn)換后
文件類型：PNG
文件存儲路徑：
oss://test-bucket/doc_images/
消息通知
將轉(zhuǎn)換結(jié)果通知發(fā)送到主題名稱為
test-topic的SMQ。
處理示例
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: OSS qn6q**************:77Dv****************
// 將類型為DOCX的文件example.docx轉(zhuǎn)換為PNG格式的圖片文件，并將轉(zhuǎn)換完成的圖片存儲到oss://test-bucket/doc_images/路徑中，最后將轉(zhuǎn)換結(jié)果通知發(fā)送到主題名稱為test-topic的SMQ。
x-oss-async-process=doc/convert,target_png,source_docx|sys/saveas,b_dGVzdC1idWNrZXQ,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw/notify,topic_dGVzdC10b3BpYw使用樣式參數(shù)處理視頻轉(zhuǎn)碼并轉(zhuǎn)存至指定Bucket
轉(zhuǎn)碼信息
轉(zhuǎn)碼前
視頻格式：AVI
視頻名稱：
example.avi
轉(zhuǎn)碼后
視頻格式：MP4
視頻名稱：
outobjprefix.mp4視頻存儲路徑：
oss://outbucket/outobjprefix.mp4
消息通知
將轉(zhuǎn)碼結(jié)果通知發(fā)送到主題名稱為
test-topic的SMQ。
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: OSS qn6q**************:77Dv****************
// 使用名為examplestyle的樣式將文件example.avi進行視頻轉(zhuǎn)碼，轉(zhuǎn)碼完成后將得到的文件保存為oss://outbucket/outobjprefix.mp4，最后將轉(zhuǎn)換結(jié)果通知發(fā)送到主題名稱為test-topic的SMQ。
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYwx-oss-process操作對應(yīng)消息格式
功能模塊 | x-oss-process操作 | 消息格式 |
文檔處理 | ||
媒體處理 | ||
文件處理 |