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