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