調用CreateUploadMedia擷取媒資上傳地址和憑證-智能媒體服務-阿里雲 - Intelligent Media Services

介面說明

獲取上傳地址和憑證為智能媒體服務的核心基礎，是每個上傳操作的必經過程。
如果影片上傳憑證失效（預設有效期為 3000 秒），請呼叫重新整理影片上傳憑證介面重新獲取上傳憑證。
上傳後，可透過設定回呼，接收上傳事件通知或呼叫 GetMediaInfo 介面根據返回的媒資狀態來判斷是否上傳成功。
本介面返回的 MediaId 參數，可以用於媒資生命週期管理或媒體處理。

使用限制

本介面僅支援上傳至 VOD 隨選視訊儲存，不支援上傳至使用者自有 OSS 儲存。使用自有 OSS 儲存的使用者，可以先透過 OSS SDK 上傳檔案至 OSS，再呼叫 RegisterMediaInfo 介面將 OSS 檔案註冊至媒資庫。
本介面目前僅支援華東 2（上海）、華北 2（北京）、華南 1（深圳）地域。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:CreateUploadMedia

create

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
AppId	string	否	應用程式 ID。預設取值：app-1000000。	app-1000000
EntityId	string	否	實體 ID。可呼叫 CreateEntity 介面建立實體，自訂動態中繼資料結構。	9e177cac2fb44f8b8c67b199fcc7bffd
FileInfo	string	否	檔案資訊，JSON 類型，包含參數欄位： Type（必填）：檔案類型，取值 video、image、audio、text、other。 Name（必填）：檔案名稱，不帶副檔名。 Size（選填）：檔案大小。 Ext（必填）：檔案副檔名。	{\"Type\":\"video\",\"Name\":\"test\",\"Size\":108078336,\"Ext\":\"mp4\"}
UserData	string	否	自訂設定。為 JSON 字串，支援訊息回呼等設定。	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
UploadTargetConfig	string	否	目標儲存地址。 StorageType 取值：僅支援 oss。 StorageLocation 僅支援 VOD 隨選視訊儲存，不支援使用者自有 OSS 儲存。	{\"StorageType\":\"oss\",\"StorageLocation\":\"outin-***.oss-cn-shanghai.aliyuncs.com\"}
MediaMetaData	string	否	上傳媒資的中繼資料，JSON 格式。 Title 標題（必填）：長度不超過 128 個字元。 UTF-8 編碼。 Description 描述（選填）：長度不超過 1024 個字元。 UTF-8 編碼。 CateId 分類 ID（選填）。 Tags 標籤（選填）。 BusinessType 業務類型（必填），取值： Type = video ，取值： opening：片頭/開場；ending：片尾 Type = image ，取值： default：預設； cover：封面 Type = text ，取值： subtitles：字幕； font：字型； Type=material ，取值： watermark：浮水印； general 通用； CoverURL 封面（選填）。 DynamicMetaData 動態中繼資料，類型為字串。	{\"Title\": \"UploadTest\", \"Description\": \"UploadImageTest\", \"Tags\": \"tag1,tag2\",\"BusinessType\":\"cover\"}
PostProcessConfig	string	否	Type = video \|\| audio 有上傳後處理動作。 ProcessType 取值：Workflow。說明該參數任務為非同步任務，提交後任務尚未完成，任務將進入後台排隊非同步執行。	{\"ProcessType\":\"Workflow\",\"ProcessID\":\"74ba870f1a4873a3ba238e0bf6fa9***\"}

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	4E84BE44-58A7-**-**-FBEBEA16EF94
MediaId	string	媒資 ID。	**20b48fb04483915d4f2cd8ac**
MediaURL	string	媒資地址。說明如果設定了 CDN 網域則返回 CDN 地址，否則為 OSS 地址。說明如果返回的 MediaURL 在瀏覽器無法存取（403），是因為您開啟了隨選視訊網域的驗證功能。可關閉 URL 驗證或自助產生驗證簽章。	https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4
FileURL	string	檔案 OSS 地址（不帶驗證）。	http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4
UploadAddress	string	上傳地址。說明介面返回的上傳地址是 Base64 加密後的值。呼叫 SDK 或 API 完成媒資上傳時需要對其進行 Base64 解碼後再使用。僅 OSS 原生 SDK 或 OSS API 方式上傳需要自行解析 UploadAddress。	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuth	string	上傳憑證。說明介面返回的上傳憑證是 Base64 加密後的值。呼叫 SDK 或 API 完成媒資上傳時需要對其進行 Base64 解碼後再使用。僅 OSS 原生 SDK 或 OSS API 方式上傳需要自行解析 UploadAuth。	eyJFbmRwb2ludCI6Imm****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "4E84BE44-58A7-****-****-FBEBEA16EF94",
  "MediaId": "****20b48fb04483915d4f2cd8ac****",
  "MediaURL": "https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4",
  "FileURL": "http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。