異步任務(wù)輕量消息隊(duì)列(原 MNS)消息處理示例
本文介紹如何通過輕量消息隊(duì)列(原 MNS)獲取IMM異步任務(wù)的執(zhí)行狀態(tài)消息。
創(chuàng)建輕量消息隊(duì)列(原 MNS)相關(guān)資源
步驟一:創(chuàng)建輕量消息隊(duì)列主題
在左側(cè)導(dǎo)航欄選擇主題列表,并單擊創(chuàng)建主題。
在創(chuàng)建主題面板設(shè)置主題的相關(guān)信息,如下以創(chuàng)建名稱為tf-test-mns-topic的主題為例。
單擊確定。
步驟二:創(chuàng)建輕量消息隊(duì)列(原 MNS)隊(duì)列
在左側(cè)導(dǎo)航欄選擇隊(duì)列列表,并單擊創(chuàng)建隊(duì)列。
在創(chuàng)建隊(duì)列面板設(shè)置隊(duì)列的相關(guān)信息,如下以創(chuàng)建名稱為tf-test-mns-queue的列隊(duì)為例。
單擊確定。
步驟三:關(guān)聯(lián)輕量消息隊(duì)列(原 MNS)主題與隊(duì)列
在左側(cè)導(dǎo)航欄選擇主題列表,并單擊步驟一:創(chuàng)建輕量消息隊(duì)列(原 MNS)主題中創(chuàng)建的主題名稱,即tf-test-mns-topic,如下圖所示。
選擇訂閱列表,并單擊創(chuàng)建訂閱。
在創(chuàng)建訂閱面板,創(chuàng)建名稱為tf-test-mns-subscription的訂閱,如下圖所示。
訂閱類型:選擇隊(duì)列。
接收端地址:選擇tf-test-mns-queue,即步驟二:創(chuàng)建輕量消息隊(duì)列(原 MNS)隊(duì)列中創(chuàng)建的隊(duì)列名稱。
消息格式:選擇JSON。
單擊確定。
可選:創(chuàng)建OSS資源
如果阿里云OSS中已有相關(guān)資源,可以跳過此步驟,自行發(fā)起IMM調(diào)用。
步驟一:創(chuàng)建Bucket
在左側(cè)導(dǎo)航欄選擇Bucket列表,并單擊創(chuàng)建Bucket。
在創(chuàng)建Bucket面板,創(chuàng)建名稱為tf-test-oss-bucket的Bucket。
步驟二:上傳文件
在左側(cè)導(dǎo)航欄選擇Bucket列表,并單擊tf-test-oss-bucket,即步驟一:創(chuàng)建Bucket中創(chuàng)建的Bucket名稱。
單擊上傳文件,根據(jù)頁面提示上傳文件1.docx,文件上傳完成后如下圖所示。
發(fā)起IMM調(diào)用
步驟一:創(chuàng)建Project
在左側(cè)導(dǎo)航欄選擇項(xiàng)目列表,并單擊創(chuàng)建項(xiàng)目。
在創(chuàng)建項(xiàng)目面板,創(chuàng)建名稱為tf-test-imm-project,服務(wù)角色為AliyunIMMDefaultRole的項(xiàng)目,如下圖所示。
重要如果使用自定義服務(wù)角色, 角色權(quán)限設(shè)置請(qǐng)參見為項(xiàng)目配置授權(quán)角色。
單擊確定。
步驟二:發(fā)起IMM調(diào)用
在左側(cè)API列表選擇文檔處理>CreateOfficeConversionTask接口。
填寫如下圖所示的參數(shù)信息。
ProjectName:填寫tf-test-imm-project,即步驟一:創(chuàng)建Project中創(chuàng)建的項(xiàng)目名稱。
SourceURI:填寫oss://tf-test-oss-bucket/1.docx,即步驟二:上傳文件中上傳或已經(jīng)存在的OSS源文件的存儲(chǔ)地址。
TargetURIPrefix:填寫oss://tf-test-oss-bucket/output,即文檔轉(zhuǎn)換后輸出文件的存儲(chǔ)地址前綴。
TargetType:填寫png,即轉(zhuǎn)換輸出的目標(biāo)文件類型。
TopicName:填寫tf-test-mns-topic,即步驟一:創(chuàng)建輕量消息隊(duì)列(原 MNS)主題中創(chuàng)建的輕量消息隊(duì)列(原 MNS)主題名稱。
單擊發(fā)起調(diào)用。
接收輕量消息隊(duì)列(原 MNS)消息
在左側(cè)導(dǎo)航欄選擇隊(duì)列列表,單擊tf-test-mns-queue,即步驟二:創(chuàng)建輕量消息隊(duì)列(原 MNS)隊(duì)列中創(chuàng)建的列隊(duì)名稱,如下圖所示。
在隊(duì)列詳情頁面右上方單擊收發(fā)消息,如下圖所示。
在收發(fā)消息頁面,單擊接收消息,頁面會(huì)新增一條消息,如下圖所示。
在消息所在行的操作列,單擊詳情,查看消息詳情,如下圖所示。
常見問題
為什么收不到輕量消息隊(duì)列(原 MNS)消息?
無法收到輕量消息隊(duì)列(原 MNS)消息時(shí),請(qǐng)確認(rèn)以下信息:
檢查輕量消息隊(duì)列(原 MNS)主題和IMM項(xiàng)目是否在同一個(gè)地域。
檢查輕量消息隊(duì)列(原 MNS)主題和隊(duì)列是否綁定成功且消息推送格式為JSON。
檢查是否有多個(gè)消費(fèi)者在同時(shí)消費(fèi)隊(duì)列。
檢查IMM項(xiàng)目授權(quán)角色是否有發(fā)送輕量消息隊(duì)列(原 MNS)權(quán)限,關(guān)于授權(quán)角色,請(qǐng)參見為項(xiàng)目配置授權(quán)角色。