上傳外部存儲的轉碼流文件并掛載到對應的點播媒資下。
接口說明
- 請確保在使用該接口前,已充分了解視頻點播產品的收費方式和價格。媒資文件上傳到視頻點播中會產生存儲費用,計費詳情,請參見媒資存儲計費。如果您已開通了存儲傳輸加速,則上傳媒資文件到視頻點播時還將涉及上傳加速費用,計費詳情請參見存儲傳輸加速計費。
- 該接口目前僅支持上海和新加坡地域使用。
- 調用本接口上傳外部存儲的轉碼流文件并掛載到對應的點播媒資下。本接口支持的轉碼流 HDR 類型為 HDR、HDR10、HLG、DolbyVision、HDRVivid 和 SDR+類型。
- 您可以通過獲取 URL 上傳信息接口來查詢上傳狀態,上傳完成后會收到 URL 上傳轉碼流完成的事件通知。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
vod:UploadStreamByURL | create | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
StreamURL | string | 是 | 轉碼流文件 URL。 如果轉碼流的 URL 需要鑒權,需要在 StreamURL 中傳入鑒權參數,并確保該 URL 可以通過公網訪問。 說明
URL 可以通過控制臺獲取音視頻的地址;也可以通過 getplayinfo 接口調用來獲取音視頻地址。
| https://example.com/lesson-01.mp4 |
MediaId | string | 是 | 轉碼流對應的點播媒資 ID。 | ca3a8f6e49*****57b65806709586 |
Definition | string | 是 | 視頻流清晰度。 取值,詳情請參考: 媒資參數說明-清晰度。 | HD |
FileExtension | string | 否 | 轉碼流文件擴展名。 擴展名請參見概述中的音頻和視頻的支持文件格式。 當該參數不為空時,會覆蓋 StreamURL 地址中的文件擴展名。 注意 若 StreamURL 地址中不含文件擴展名,該參數必填。 | mp4 |
HDRType | string | 否 | 轉碼流 HDR 類型。取值:
說明
| HDR10 |
UserData | string | 否 | {"MessageCallback":{"CallbackURL":"http://aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}} | |
UploadMetadata | string | 否 | 上傳媒體文件的元數據信息,為 JSON 字符串。
| {"AddressMapping":"1","CustomPath":"test/xxx","CustomFileName":"xxx.mp4","isOverwritePath":"0"} |
UploadMetadata
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
AddressMapping | String | 否 | 地址映射規則。取值:1 代表映射轉碼流的 URL,2 代表自定義路徑 |
CustomPath | String | 否 | 自定義文件路徑。長度不超過 1000 個字節。UTF-8 編碼。 |
CustomFileName | String | 否 | 自定義文件名稱。長度不超過 1000 個字節。UTF-8 編碼。 |
IsOverwritePath | String | 否 | 自定義文件路徑存在時是否覆蓋。取值:0 代表不覆蓋,1 代表覆蓋 |
說明
當 AddressMapping 取值為 2 時,CustomPath 和 CustomFileName 均不能為空
當 IsOverwritePath 取值為 0 時,如果自定義的文件路徑已經存在,接口會返回失敗
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "7AE96389-DF1E-598D-816B-7B40F13B4620",
"StreamJobId": "e304b34fb3d959f92baef97b6496****",
"FileURL": "http://outin-31059bcee7810a200163e1c8dba****.oss-cn-shanghai.aliyuncs.com/lesson-01.mp4",
"SourceURL": "https://example.com/lesson-01.mp4"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-12-18 | OpenAPI 入參發生變更 | 查看變更詳情 |
2021-12-22 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
2021-12-20 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
2021-11-16 | OpenAPI 入參發生變更 | 查看變更詳情 |
2021-10-28 | 新增 OpenAPI | 查看變更詳情 |