設置消息通知
媒體處理中的任務分為同步任務和異步任務,異步任務無法實時接收到任務結(jié)果。如果您需要獲取異步任務執(zhí)行狀態(tài),如獲取轉(zhuǎn)碼任務是否成功、智能審核任務是否已完成等,您可以設置消息通知監(jiān)控管道或工作流內(nèi)任務狀態(tài)的變化情況。本文介紹在媒體處理中為任務設置消息通知的操作步驟。
您可以根據(jù)以下流程為您的任務設置消息通知。
根據(jù)實際業(yè)務需要,創(chuàng)建主題或隊列。
說明隊列模型提供高可靠、高并發(fā)的一對一消費模型;主題模型提供一對多的發(fā)布訂閱模型。
(可選)綁定管道。
設置消息通知。
步驟一、開通輕量消息隊列(原 MNS)
媒體處理的消息通知是綁定MNS產(chǎn)品推送的,媒體處理側(cè)不產(chǎn)生費用,但是會產(chǎn)生MNS費用。計費詳情請參見計費說明。
開通輕量消息隊列(原 MNS)并授權。詳細操作請參見開通輕量消息隊列(原 MNS)并授權。
單擊管理控制臺進入輕量消息隊列(原 MNS)控制臺。
步驟二、創(chuàng)建主題或隊列
媒體處理支持接收MNS主題和隊列消息,您可以根據(jù)實際業(yè)務需要創(chuàng)建主題或隊列。
創(chuàng)建主題
在MNS控制臺左側(cè)導航欄選擇主題列表,在主題列表頁面單擊創(chuàng)建主題。
在創(chuàng)建主題頁面,填寫如下參數(shù),完成配置。
參數(shù)
說明
名稱
主題名稱。
說明主題名稱必須以英文字母開頭,剩余名稱可以是英文、數(shù)字、短劃線(-),長度不超過120個字符。
消息最大長度
允許發(fā)送到該主題的消息體的最大長度。取值:1024~65536,默認為65536,單位為Byte。
啟用日志功能
選擇是否啟用日志功能。
單擊確定,完成創(chuàng)建主題,跳轉(zhuǎn)至主題詳情頁面。
單擊創(chuàng)建訂閱,并配置相關參數(shù)。
參數(shù)
說明
名稱
訂閱名稱。
說明名稱必須以英文字母開頭,剩余名稱可以包含英文字母、數(shù)字、短劃線(-),名稱不超過255個字符。
推送類型
在下拉列表中選擇推送類型,默認為HTTP。
接收端地址
消息的接收端地址。
說明HTTP地址,必須以http://或者https://開頭。
(可選)消息過濾標簽
通過設置的標簽對消息進行過濾。
說明用于消息過濾,不超過16個字符。
重試策略
向接收端推送消息出現(xiàn)錯誤時的重試策略。
退避重試:重試3次,間隔時間為10~20秒之間的一個隨機值。
指數(shù)衰減重試:重試176次,總計重試時間為1天,間隔時間單位為秒,依次為:2^0,2^1,…,512,512,…,512。
消息推送格式
推送給用戶的消息格式。
SIMPLIFIED:消息體即用戶發(fā)布的消息,不包含任何屬性信息。
JSON:消息體為JSON格式,包含消息正文和消息屬性。
XML:消息體為XML格式,包含消息正文和消息屬性。
單擊確定,完成創(chuàng)建。
創(chuàng)建隊列
在MNS控制臺左側(cè)導航欄,單擊隊列列表。
在隊列列表頁面,單擊創(chuàng)建隊列,并配置如下參數(shù)。
參數(shù)
描述
名稱
隊列名稱。
消息最大長度
發(fā)送到隊列的消息體的最大長度。
長輪詢時間
當隊列中沒有消息時,該隊列的ReceiveMessage請求的最大等待時長。
消息可見性超時時間
消息從隊列中取出后從Active狀態(tài)變成Inactive狀態(tài)后的持續(xù)時間。
消息保存時長
消息在隊列中的最長存活時間。從發(fā)送到隊列開始經(jīng)過此參數(shù)指定的時間后,不論消息是否被取出都將被刪除。
消息定時時間
發(fā)送到隊列的所有消息將延后此參數(shù)指定的時間后被消費。
啟用日志功能
是否開啟日志管理功能。
配置完成后單擊確定完成隊列創(chuàng)建。
(可選)步驟三、綁定管道
如果您需要使用普通管道進行單任務操作并接收消息通知,則需要為您為主題通知或隊列綁定管道,在創(chuàng)建單任務時選擇綁定了主題通知(隊列)的管道即可正常接收消息。
如果您使用工作流,則無需綁定管道。媒體處理中通過工作流觸發(fā)執(zhí)行的作業(yè),忽略管道上綁定的消息機制。如需在工作流中使用消息通知,創(chuàng)建工作流時輸入節(jié)點選擇所需消息通知的主題(隊列)即可。具體操作,請參見為工作流任務設置消息通知。
登錄媒體處理控制臺。
在頂部菜單欄左側(cè)選擇地域。
說明管道地域需要和提交任務的地域一致,否則會導致無法接收消息。
在左側(cè)導航欄中,選擇 。
在管道列表中,選擇需要開啟消息通知的管道,單擊設置消息通知。
在設置消息通知頁面,按照下表設置參數(shù)。
參數(shù)
說明
消息通知
打開消息通知開關。
消息類型
支持隊列和通知兩種消息類型。按需選擇您需要的消息類型。
隊列名稱
消息類型選擇隊列時,在隊列名稱下拉列表中選擇所需隊列。
通知名稱
消息類型選擇通知時,在通知名稱下拉列表中選擇所需的通知。
單擊確定,完成綁定。
步驟四、設置消息通知
為單任務設置消息通知
在創(chuàng)建單任務時選擇對應任務類型的已綁定消息通知的管道,當加入到該管道中的非工作流任務狀態(tài)更新時,會向指定的主題或隊列發(fā)送消息通知。
管道類型需要與任務類型對應,例如:您需要創(chuàng)建智能封面單任務,則需要在智能封面管道上開啟消息通知并綁定對應主題或隊列,并且在創(chuàng)建任務時選擇該管道。
為工作流設置消息通知
打開工作流輸入節(jié)點的消息通知開關,工作流中的任務開始執(zhí)行和執(zhí)行完成時,會向指定的主題或隊列發(fā)送消息通知。
在媒體處理控制臺,左側(cè)導航欄選擇 。
單擊創(chuàng)建工作流,進入創(chuàng)建工作流頁面。
在工作流拓撲結(jié)構編輯頁面,單擊輸入節(jié)點右側(cè)的筆形圖標。
在輸入設置頁面,打開消息通知開關,其余參數(shù)按下表設置。
說明目前工作流觸發(fā)執(zhí)行的任務,可忽略管道上綁定的消息機制,以創(chuàng)建工作流時輸入節(jié)點綁定的消息機制為準。
參數(shù)
描述
輸入Bucket
選擇輸入路徑后自動顯示。
輸入路徑
待處理文件的輸入路徑。
轉(zhuǎn)碼管道
選擇在上一步中已經(jīng)綁定的轉(zhuǎn)碼管道。
消息通知
單擊開啟消息通知。
消息類型
需要接收的消息類型。根據(jù)您管道綁定的消息類型選擇。
隊列(通知)名稱
選擇對應的隊列(主題通知)。
其余節(jié)點具體操作請參見創(chuàng)建工作流。
常見問題
消息通知常見問題說明請參見FAQ。