全部產品
Search
文件中心

Intelligent Media Management:非同步任務輕量訊息佇列(原 MNS)訊息處理樣本

更新時間:Jun 03, 2026

本文介紹如何通過輕量訊息佇列(原 MNS)擷取IMM非同步任務的執行狀態訊息。

建立輕量訊息佇列(原 MNS)相關資源

步驟一:建立輕量訊息佇列主題

  1. 登入輕量訊息佇列(原 MNS)管理主控台

  2. 在左側導覽列選擇主題列表,並單擊建立主題

  3. 建立主題面板設定主題的相關資訊,如下以建立名稱為tf-test-mns-topic的主題為例。

    設定訊息最大長度65536啟用日誌功能選擇

  4. 單擊確定

步驟二:建立輕量訊息佇列(原 MNS)隊列

  1. 登入輕量訊息佇列(原 MNS)管理主控台

  2. 在左側導覽列選擇隊列列表,並單擊建立隊列

  3. 建立隊列面板設定隊列的相關資訊,如下以建立名稱為tf-test-mns-queue的列隊為例。

    隊列配置參數:訊息最大長度設定為 64 KB,長輪詢時間設定為 0 秒(即關閉長輪詢),訊息可見度逾時時間設定為 30 秒,訊息儲存時間長度設定為 4 天,訊息定時時間設定為 0 秒,啟用日誌功能保持關閉狀態。

  4. 單擊確定

步驟三:關聯輕量訊息佇列(原 MNS)主題與隊列

  1. 登入輕量訊息佇列(原 MNS)管理主控台

  2. 在左側導覽列選擇主題列表,並單擊步驟一:建立輕量訊息佇列(原 MNS)主題中建立的主題名稱,即tf-test-mns-topic

  3. 選擇訂閱列表,並單擊建立訂閱

  4. 建立訂閱面板,建立名稱為tf-test-mns-subscription的訂閱,如下所示。

  5. 單擊確定

可選:建立OSS資源

說明

如果阿里雲OSS中已有相關資源,可以跳過此步驟,自行發起IMM調用

步驟一:建立Bucket

  1. 登入OSS管理主控台

  2. 在左側導覽列選擇Bucket 列表,並單擊建立 Bucket

  3. 建立 Bucket面板,建立名稱為tf-test-oss-bucket的Bucket。

步驟二:上傳檔案

  1. 登入OSS管理主控台

  2. 在左側導覽列選擇Bucket 列表,並單擊tf-test-oss-bucket,即步驟一:建立Bucket中建立的Bucket名稱。

  3. 單擊上傳文件,根據頁面提示上傳檔案1.docx,檔案上傳完成後即可進行下一步操作。

發起IMM調用

步驟一:建立Project

  1. 登入IMM管理主控台

  2. 在左側導覽列選擇项目列表,並單擊创建项目

  3. 创建项目面板,建立名稱為tf-test-imm-project,服務角色為AliyunIMMDefaultRole的專案。

    重要

    如果使用自訂服務角色, 角色使用權限設定請參見為專案配置授權角色

  4. 單擊確定

步驟二:發起IMM調用

  1. 登入OpenAPI平台

  2. 在左側API列表選擇文檔處理>CreateOfficeConversionTask介面。

  3. 填寫以下參數資訊。

    • ProjectName:填寫tf-test-imm-project,即步驟一:建立Project中建立的專案名稱。

    • SourceURI:填寫oss://tf-test-oss-bucket/1.docx,即步驟二:上傳檔案中上傳或已經存在的OSS源檔案的儲存地址。

    • TargetURIPrefix:填寫oss://tf-test-oss-bucket/output,即文檔轉換後輸出檔案的儲存地址首碼。

    • TargetType:填寫png,即轉換輸出的目標檔案類型。

    • TopicName:填寫tf-test-mns-topic,即步驟一:建立輕量訊息佇列(原 MNS)主題中建立的輕量訊息佇列(原 MNS)主題名稱。

  4. 單擊發起調用

接收輕量訊息佇列(原 MNS)訊息

  1. 登入輕量訊息佇列(原 MNS)管理主控台

  2. 在左側導覽列選擇隊列列表,單擊tf-test-mns-queue,即步驟二:建立輕量訊息佇列(原 MNS)隊列中建立的隊列名稱。

  3. 隊列詳情頁面右上方單擊收發訊息

  4. 收發訊息頁面,單擊接收訊息,頁面會新增一條訊息。

    接收到的訊息記錄包含 訊息ID被消費次數首次消費時間訊息建立時間操作詳情刪除)列。

  5. 在訊息所在行的操作列,單擊詳情,查看訊息詳情。

    訊息詳情彈窗中包含基礎資訊(訊息 ID被消費次數首次消費時間訊息建立時間下次可見時間訊息控制代碼)和訊息原始內容地區,其中訊息類型為 imm:Task:OfficeConversion,來源為 acs.imm,表明 IMM 文檔轉換任務已成功觸發。下方還展示Base64 解碼後的訊息內容訊息 MD5 內容

常見問題

為什麼收不到輕量訊息佇列(原 MNS)訊息?

無法收到輕量訊息佇列(原 MNS)訊息時,請確認以下資訊:

  • 檢查輕量訊息佇列(原 MNS)主題和IMM專案是否在同一個地區。

  • 檢查輕量訊息佇列(原 MNS)主題和隊列是否綁定成功且訊息推送格式JSON

  • 檢查是否有多個消費者在同時消費隊列。

  • 檢查IMM專案授權角色是否有發送輕量訊息佇列(原 MNS)許可權,關於授權角色,請參見為專案配置授權角色