修改媒資存儲類型。
接口說明
-
請確保在使用該接口前，已充分了解視頻點播產品的收費方式和價格。視頻點播中修改媒資存儲類型會產生存儲費用，計費詳情，請參見媒資存儲計費。
-
修改媒資存儲類型是一個異步操作，整體完成后給用戶發送回調。
-
若媒資當前的存儲類型為歸檔或冷歸檔，調用本接口會自動觸發解凍，解凍完成后修改存儲類型，不需要用戶手動調用 RestoreMedia 接口解凍媒資。其中冷歸檔需要傳入解凍優先級，默認為 RestoreTier=Standard。
-
變更中的媒資不能再次發起變更任務，不能進行生產、處理。
-
非標準存儲的媒資有最低存儲時長要求，低頻/源文件低頻至少存儲 30 天；歸檔/源文件歸檔至少存儲 60 天；冷歸檔、源文件冷歸檔至少存儲 180 天。如果存儲時長不夠，修改媒資存儲類型，會產生不足規定時間的存儲費用，例如：低頻訪問存儲 10 天后通過接口修改存儲類型為標準存儲，會一次性產生 20 天的低頻訪問存儲費用，總共 30 天的低頻訪問存儲費用。
-
暫不支持修改自有 bucket 存儲類型。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vod:UpdateMediaStorageClass | update | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| MediaIds | string | 是 | 媒體 ID，即音/視頻 ID（VideoId）。多個 ID 之間使用半角逗號（,）分隔，最多支持 20 個。可通過以下方式獲取：
| d56c2ac0cee271ed80004710b5ba**** |
| Scope | string | 否 | 變更范圍，不傳則取默認值 All。取值：
| All |
| StorageClass | string | 是 | 存儲類型。取值：
| Archive |
| RestoreTier | string | 否 | 解凍優先級（僅冷歸檔媒資需要）。不傳則取默認值 Standard，取值：
| Standard |
| AllowUpdateWithoutTimeLimit | boolean | 否 | 是否允許存儲時長不足的媒資進行存儲類型變更。取值：
說明
如果媒資存儲時長不足，強制進行存儲類型變更，會涉及額外的取回費用。
| false |
對于冷歸檔類型的媒資，您可以指定解凍天數和解凍優先級，解凍天數最短為 1 天，最長為 365 天。不同解凍優先級的取回時間如下：
- 高優先級（Expedited）：表示 1 小時內完成解凍。
- 標準（Standard）：表示 2~5 小時內完成解凍。
- 批量（Bulk）：表示 5~12 小時內完成解凍。
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "30FA0B7C-3A81-5449-93CD-ACA149E6****",
"Status": "Processing",
"IgnoredList": {
"MediaId": [
"['19e231ee6e3e417fbf2e92ec2680****']"
]
},
"ForbiddenList": {
"MediaForbiddenReasonDTO": [
{
"MediaId": "19e231ee6e3e417fbf2e92ec2680****",
"Reason": "TargetStorageClassInconsistent"
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-08-18 | API 內部配置變更，不影響調用 | 查看變更詳情 |