上傳地址和憑證由點播服務提供，旨在解決授權與安全問題，防止惡意上傳，并自動創建用于管理和處理的媒資ID（Mediaid）。輔助媒資如水印、字幕等，通過調用本接口獲取上傳憑證并創建相應媒資信息。
接口說明
- 請確保在使用該接口前，已充分了解視頻點播產品的收費方式和價格。媒資文件上傳到視頻點播中會產生存儲費用，計費詳情，請參見媒資存儲計費。如果您已開通了存儲傳輸加速，則上傳媒資文件到視頻點播時還將涉及上傳加速費用，計費詳情請參見存儲傳輸加速計費。
- 本接口僅用于獲取上傳地址和憑證以及創建媒資基礎信息，并非上傳文件，通過接口上傳的完整示例，請參見通過視頻點播 API 上傳媒資文件。
- 如果上傳憑證失效（有效期 3000 秒），請重新調用此接口獲取上傳地址和憑證。
- 可通過配置回調，接收輔助媒資上傳完成的事件通知來判斷是否上傳成功。
- 獲取上傳地址和憑證為點播服務的核心基礎，是每個上傳操作的必經過程。點播服務提供多種不同的上傳方式，每種方式對獲取上傳地址和憑證的要求不同，詳細內容請參見上傳地址和憑證的使用說明。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vod:CreateUploadAttachedMedia | create | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Title | string | 否 | 輔助媒資的標題。規則：
| 測試 |
| BusinessType | string | 是 | 輔助媒資的類型。取值：
| watermark |
| MediaExt | string | 是 | 待上傳的輔助媒資源文件的擴展名。取值：
| png |
| FileName | string | 否 | 待上傳的輔助媒資的源文件地址。 說明
可不帶擴展名；若此處帶了擴展名，且此處的擴展名與 MediaExt 中設置的擴展名不一致，以 MediaExt 為準。
| D:\test.png |
| FileSize | string | 否 | 文件大小。單位：字節。 | 123 |
| Tags | string | 否 | 標簽。規則：
| tag1,tag2 |
| StorageLocation | string | 否 | 存儲地址。可通過以下方式獲取： 登錄點播控制臺，選擇配置管理 > 媒資管理配置 > 存儲管理查看存儲地址。 說明
若不傳此參數，則輔助媒資上傳到默認的存儲地址上；若傳入此參數，則輔助媒資上傳到該指定的存儲地址上。
| out-****.oss-cn-shanghai.aliyuncs.com |
| Description | string | 否 | 媒資描述。規則：
| uploadTest |
| UserData | string | 否 | {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}} | |
| CateIds | string | 否 | 分類 ID。多個 ID 之間使用半角逗號（,）分隔。最多支持 5 個。可通過以下方式獲取：
| 1298****,0813**** |
| AppId | string | 否 | 應用 ID。默認取值：app-1000000。若已開通多應用體系，傳入應用 ID，可將輔助媒資上傳到指定應用下。更多信息，請參見多應用。 | app-**** |
返回參數
示例
正常返回示例
JSON格式
{
"FileURL": "https://****.oss-cn-shanghai.aliyuncs.com/watermark/****.mov",
"RequestId": "73254DE5-F260-4720-D06856B63C01****",
"UploadAddress": "LWNuLXNoYW5naGFpLmFsaXl1b****",
"MediaId": "97dc17a5abc3668489b84ce9****",
"MediaURL": "http://example.aliyundoc.com/watermark/****.mov?auth_key=****",
"UploadAuth": "UzFnUjFxNkZ0NUIZTaklyNWJoQ00zdHF****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史