基于源文件URL，拉取音視頻媒體文件進行上傳，支持批量上傳。
接口說明
- 請確保在使用該接口前，已充分了解視頻點播產(chǎn)品的收費方式和價格。媒資文件上傳到視頻點播中會產(chǎn)生存儲費用，計費詳情，請參見媒資存儲計費。如果您已開通了存儲傳輸加速，則上傳媒資文件到視頻點播時還將涉及上傳加速費用，計費詳情請參見存儲傳輸加速計費。
- 本接口支持上傳的媒體文件格式，請參見媒體格式。
- 本接口主要適用于文件沒有存儲在本地服務(wù)器或終端，需要通過公網(wǎng)訪問的 URL 地址上傳的場景。
- 本接口為異步上傳接口，非實時，不保證時效性，一般提交后會在數(shù)小時、甚至數(shù)天內(nèi)完成遷移上傳。如果對時效性要求較高，建議使用上傳 SDK 上傳。
- 如果配置了回調(diào)，則上傳完成后會收到 URL 上傳視頻完成的事件通知，可以通過獲取 URL 上傳信息接口查詢上傳狀態(tài)。
- 上傳任務(wù)提交成功后，會在云端生成異步執(zhí)行的任務(wù)，相應(yīng)服務(wù)地域下所有用戶提交的 URL 上傳任務(wù)進行排隊執(zhí)行，完成時間受已有任務(wù)數(shù)量影響；上傳完成后可根據(jù)事件通知（消息回調(diào)）返回的 URL 和視頻 ID 等信息進行關(guān)聯(lián)。
- 本接口目前僅支持華東 2（上海）和新加坡地域。
- 同一個媒體文件 URL，每次提交上傳任務(wù)都會在點播中產(chǎn)生一個新的媒體資源（即產(chǎn)生新的媒體 ID）。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，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:UploadMediaByURL | *全部資源 * |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| UploadURLs | string | 是 | 媒體源文件 URL。
說明
| https://****.mp4 |
| TemplateGroupId | string | 否 | 轉(zhuǎn)碼模板組 ID。可通過以下方式獲取：
說明
UploadMetadatas中進行設(shè)置，如果在 UploadMetadatas 中設(shè)置了 TemplateGroupId，此處也設(shè)置了 TemplateGroupId，則以 UploadMetadatas 中設(shè)置的 TemplateGroupId 為準(zhǔn)。 | ca3a8f6e4957b65806709586**** |
| StorageLocation | string | 否 | 媒體文件存儲地址。 登錄點播控制臺，選擇配置管理 > 媒資管理配置 > 存儲管理查看存儲地址。不指定時會使用默認(rèn)存儲地址。 | outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com |
| UploadMetadatas | string | 否 | 上傳媒體文件的元數(shù)據(jù)信息，為 JSON 字符串。
| [{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}] |
| UserData | string | 否 | 自定義設(shè)置。為 JSON 字符串，支持消息回調(diào)、上傳加速等設(shè)置。更多信息，請參見 UserData 。 說明
| {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}} |
| AppId | string | 否 | 應(yīng)用 ID。默認(rèn)取值：app-1000000。 更多信息，請參見多應(yīng)用。 | app-**** |
| WorkflowId | string | 否 | e1e243b42548248197d6f74f9**** | |
| SessionId | string | 否 | 自定義去重識別碼，如果傳遞了該參數(shù)請求，當(dāng)檢測到在過去 10 分鐘內(nèi)曾有過相同識別碼的請求，則會在本次請求時返回錯誤。 說明
| 5c62d40299034bbaa4c195da330**** |
UploadMetadata
| 名稱 | 類型 | 是否必需 | 描述 |
|---|---|---|---|
| SourceURL | String | 是 | 需要上傳的媒體源文件 URL。 |
| Title | String | 否 | 媒體標(biāo)題。長度不超過 128 個字節(jié)。UTF-8 編碼。 |
| FileSize | String | 否 | 文件大小。 |
| Description | String | 否 | 描述。長度不超過 1024 個字節(jié)。UTF-8 編碼。 |
| CoverURL | String | 否 | 自定義視頻封面 URL 地址。 |
| CateId | String | 否 | 分類 ID。可通過登錄點播控制臺，選擇配置管理 > 媒資管理配置 > 分類管理查看分類 ID。 |
| Tags | String | 否 | 標(biāo)簽。單個標(biāo)簽不超過 32 字節(jié)，最多不超過 16 個標(biāo)簽。多個標(biāo)簽，請使用半角逗號（,）分隔。UTF8 編碼。 |
| TemplateGroupId | String | 否 | 轉(zhuǎn)碼模板組 ID。會覆蓋外層傳入的 TemplateGroupId。 |
| WorkflowId | String | 否 | 工作流 ID。如果同時傳入了 WorkflowId 和 TemplateGroupId，以 WorkflowId 為準(zhǔn)。更多信息，請參見工作流。 |
| FileExtension | String | 否 | 媒體文件擴展名，支持的擴展名，請參見上傳概述。 |
說明
UploadMetadata 中的參數(shù)（如 Title、Description、Tags 等）不能包含表情符。
為確保正常播放，當(dāng) TemplateGroupId 設(shè)置為“VOD_NO_TRANSCODE”不轉(zhuǎn)碼的方式上傳視頻文件后，目前僅以下格式的文件支持不轉(zhuǎn)碼直接播放：MP4、FLV、MP3、M3U8、WEBM，其他格式僅支持存儲（關(guān)注 FileName 的擴展名）。若使用阿里云播放器，版本須為 3.1.0 或以上。
指定不轉(zhuǎn)碼的模板組（TemplateGroupId 設(shè)置為“VOD_NO_TRANSCODE”），視頻上傳后僅有視頻上傳完成的事件通知，沒有單個清晰度轉(zhuǎn)碼完成的事件通知。
如果配置了回調(diào)，視頻上傳完成后，除了上傳和轉(zhuǎn)碼通知，還有 URL 上傳視頻完成事件通知。
批量提交時，每一個 SourceURL 有獨立的通知。
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"UploadJobs": [
{
"SourceURL": "http://example****.mp4",
"JobId": "ad90a501b1b94fb72374ad005046****"
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-05-16 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |