什麼是訊息通知 - Object Storage Service

非同步處理請求返回時僅返回任務ID，您需要在處理請求內添加訊息通知參數，以在資料處理完成時擷取到資料處理任務的結果。

注意事項

僅非同步處理支援訊息通知。
訊息通知僅支援輕量訊息佇列SMQ（原MNS）主題。關於SMQ的更多資訊，請參見SMQ快速入門。

參數說明

使用notify參數時，您需要攜帶以下選項：

參數

是否必選

描述

topic

是

SMQ主題名稱。

SMQ主題需要和Bucket處於同一地區。
填寫的主題名稱需經過URL安全的Base64編碼。例如名稱為test，填寫時為dGVzdA==。您可以使用浮水印編碼工具進行編碼處理。

如何擷取SMQ主題名稱，請參見如何通過控制台查看您的SMQ主題名稱？

使用REST API

如果對程式自訂要求較高，您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。

您可以在調用PostObject介面處理服務時，通過Body的方式傳遞x-oss-async-process，然後在處理請求中增加notify參數接收處理結果訊息通知，訊息通知僅支援SMQ主題，關於SMQ的使用，請參見Python SDK版本說明。

如下列舉各種接收SMQ訊息通知情境的處理樣本。

使用處理參數處理文檔轉換並接收SMQ訊息通知

轉換資訊

轉換前
- 檔案類型：DOCX
- 檔案名稱：example.docx
轉換後
- 檔案類型：PNG
- 檔案儲存體路徑：oss://test-bucket/doc_images/
訊息通知
將轉換結果通知發送到主題名稱為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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

// 將類型為DOCX的檔案example.docx轉換為PNG格式的圖片檔案，並將轉換完成的圖片儲存到oss://test-bucket/doc_images/路徑中，最後將轉換結果通知發送到主題名稱為test-topic的SMQ。
x-oss-async-process=doc/convert,target_png,source_docx|sys/saveas,b_dGVzdC1idWNrZXQ,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw/notify,topic_dGVzdC10b3BpYw

使用樣式參數處理視頻轉碼並轉存至指定Bucket

轉碼資訊

轉碼前
- 視頻格式：AVI
- 視頻名稱：example.avi
轉碼後
- 視頻格式：MP4
- 視頻名稱：outobjprefix.mp4
- 視頻儲存路徑：oss://outbucket/outobjprefix.mp4
訊息通知
將轉碼結果通知發送到主題名稱為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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
 // 使用名為examplestyle的樣式將檔案example.avi進行視頻轉碼，轉碼完成後將得到的檔案儲存為oss://outbucket/outobjprefix.mp4，最後將轉換結果通知發送到主題名稱為test-topic的SMQ。
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYw

x-oss-process操作對應訊息格式

功能模組	x-oss-process操作	訊息格式
文檔處理	doc/convert	CreateOfficeConversionTask介面MNS訊息樣本
ApsaraVideo for Media Processing	video/convert video/animation video/sprite video/snapshots video/concat audio/convert audio/concat	CreateMediaConvertTask介面MNS訊息樣本
檔案處理	pointcloud/compress	CreateCompressPointCloudTask介面MNS訊息樣本
圖片處理	image/deblindwatermark	CreateDecodeBlindWatermarkTask介面MNS訊息樣本

常見問題

如何通過控制台查看您的SMQ主題名稱？

為了協助您更清晰地配置與OSS事件通知相關的輕量訊息佇列SMQ（原MNS）主題，您可以參照如下步驟找到並確認與OSS同地區的SMQ主題名稱。

登入輕量訊息佇列SMQ（原MNS）控制台。
在控制台頂部功能表列，確保您選擇了與您的OSS Bucket相同的地區。
在左側導覽列中，點擊主題模型 > 主題列表，展示出目前範圍下所有已建立的主題。
瀏覽主題列表，尋找與您的OSS事件通知配置相匹配的主題名稱。

通過以上步驟，您可以有效地定位並配置與OSS同地區的SMQ主題名稱，確保OSS事件能夠被正確地發送到訊息佇列中進行處理。