點播服務下發上傳地址和憑證以保障授權和安全，防止惡意上傳，并在下發時自動創建圖片ID（ImageId）用于管理。通過調用本接口可獲取上傳所需地址和憑證，并創建圖片信息。
接口說明
- 請確保在使用該接口前，已充分了解視頻點播產品的收費方式和價格。媒資文件上傳到視頻點播中會產生存儲費用，計費詳情，請參見媒資存儲計費。如果您已開通了存儲傳輸加速，則上傳媒資文件到視頻點播時還將涉及上傳加速費用，計費詳情請參見存儲傳輸加速計費。
- 本接口僅用于獲取上傳地址和憑證以及創建媒資基礎信息，并非上傳文件，通過接口上傳的完整示例，請參見通過視頻點播 API 上傳媒資文件。
- 上傳圖片不支持刷新上傳地址和憑證。如果圖片上傳憑證失效（ 默認有效期 3000 秒），請重新調用此接口獲取上傳地址和憑證。
- 可通過配置回調，接收圖片上傳完成的事件通知來判斷是否上傳成功。
- 獲取上傳地址和憑證為點播服務的核心基礎，是每個上傳操作的必經過程。點播服務提供多種不同的上傳方式，每種方式對獲取上傳地址和憑證的要求不同，詳細內容請參見上傳地址和憑證的使用說明。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vod:CreateUploadImage | create | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Title | string | 否 | 圖片標題。規則：
| mytitle |
| ImageType | string | 是 | 圖片類型。取值：
說明
點播控制臺目前僅支持對 default 類型的圖片進行查看和管理。
| default |
| ImageExt | string | 否 | 待上傳的圖片源文件的擴展名。取值：
| png |
| OriginalFileName | string | 否 | 待上傳的圖片源文件地址。 說明
可不帶擴展名；若此處帶了擴展名，且此處的擴展名與 ImageExt中設置的擴展名不一致，以ImageExt為準。
| D:\picture_01 |
| Tags | string | 否 | 圖片標簽。規則：
| 測試 |
| StorageLocation | string | 否 | 存儲地址。可通過以下方式獲取： 登錄點播控制臺，選擇配置管理 > 媒資管理配置 > 存儲管理查看存儲地址。 說明
若不傳此參數，則圖片上傳到默認的存儲地址上；若傳入此參數，則圖片上傳到該指定的存儲地址上。
| outin-****..oss-cn-shanghai.aliyuncs.com |
| CateId | long | 否 | 分類 ID。可通過以下方式獲取：
| 100036**** |
| UserData | string | 否 | {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}} | |
| Description | string | 否 | 圖片描述。
| 圖片上傳測試 |
| AppId | string | 否 | 應用 ID。默認取值：app-1000000。若已開通多應用體系，傳入應用 ID，可將圖片上傳到指定應用下。更多信息，請參見多應用。 | app-1000000 |
返回參數
示例
正常返回示例
JSON格式
{
"FileURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
"RequestId": "25818875-5F78-AEF6-D7393642****",
"UploadAddress": "eyJTZWN1cmuIjoiQ0FJU3p3TjF****",
"ImageURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
"ImageId": "93ab850b4f6f46e91d24d81d4****",
"UploadAuth": "eyJFbmmRCI6Im****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2022-10-27 | OpenAPI 入參發生變更 | 查看變更詳情 |