使用多應用體系前,請先閱讀概述瞭解相關介紹和設定,並開通點播服務。本文為您介紹使用多應用的步驟、注意事項和常見問題。
使用流程
如果您已開通點播服務,則可按照如下步驟使用多應用。
申請開通
建立應用
為身份實體授權
上傳媒資
應用獨立媒資管理
或:
申請開通
建立應用
為身份實體授權
設定回調配置
應用獨立回調配置
申請開通
申請條件
ApsaraVideo for VOD多應用體系處於公測期,點播控制台還未上線,滿足以下條件的使用者可進行申請。
近7天加速流量頻寬峰值到達500 Mbps及以上。關於如何查看流量頻寬峰值,請參見用量查詢。
開通後影響
不能禁用預設應用,否則會影響線上正常服務。
控制台上不能操作和查詢除預設應用外的資源(媒資庫、審核列表、ApsaraVideo for Media Processing配置等)。
新建立的應用需要調用API重新建立轉碼配置、回調配置等。
說明如果是測試回調功能,可以通過上傳時設定不同環境的回調地址來測試。
如果是做媒資隔離,可以用媒資分類。
開通方法
如果滿足開通條件,且接受以上影響,請提交工單。
說明申請資訊中,請註明“已知曉多應用開通後的影響,可以接受,現申請開通多應用”,以及主帳號UID。
建立應用
調用介面建立應用(單個帳號建立應用個數上限為10個,應用程式名稱不能重複)。關於建立應用介面,請參見建立應用。
首次建立必須使用主帳號AccessKey才能建立應用,後續授予RAM使用者應用管理員權限後即可操作應用和授權。
為身份實體授權
調用介面進行授權,授權後該身份實體(RAM使用者或角色)可以對應用下資源進行管理,關於授權介面,請參見為身份實體附加應用授權。關於權限原則,請參見權限原則。
使用多應用
支援多應用的服務,會增加對參數AppId
的支援,建立資源或新的設定時可指定此參數,查詢資料時也僅會返回擁有許可權的應用下的資源,而修改或刪除時會校正相關許可權。
當前,僅訊息回調和媒資服務(上傳、播放和媒資管理)支援多應用。
訊息回調
可為每個應用設定獨立的訊息回調方式和地址,配合API(設定事件通知配置)使用:
指定AppId,可設定該應用下的訊息回調。
未指定時,則使用系統預設應用。
完成設定後,不同應用下上傳的視頻、圖片等產生的事件通知會根據其設定進行相應回調。也可使用查詢事件通知配置介面查詢相關配置。
說明開啟多應用後,控制台暫時只能管理預設應用的回調配置。後續會迭代升級支援不同應用的管理。
媒資服務
媒體上傳:上傳相關介面(擷取視頻上傳地址和憑證、擷取圖片上傳地址和憑證等)支援指定AppId, 前提是該帳號實體擁有該應用的許可權,無許可權則無法上傳,不指定應用ID則上傳到系統預設應用。
音視頻播放:只能擷取到授權應用下的播放資訊(播放憑證、播放地址等)。
修改刪除:修改和刪除媒資相關操作只能操作有許可權的應用下的資源。
媒資查詢:查詢媒資詳情介面,只能擷取到有許可權的應用下的媒資資訊。批量查詢時,只返回有許可權的媒資資料,無許可權的MediaId會放入NonExistMediaIds(欄位名可能略有不同)。
媒資搜尋:搜尋時只返回有許可權的應用下的媒資資料,搜尋條件中可指定一個或多個AppId。
說明開啟多應用後,控制台媒資庫暫時只能管理授權應用下的媒體資源;後續會迭代升級支援不同應用的管理。
常見問題
使用多應用過程中的常見問題及解決方案,請參見多應用體系常見問題。