使用UpdateMediaStorageClass修改媒資的儲存類型-ApsaraVideo for VOD-阿里雲 - ApsaraVideo VOD

介面說明

請確保在使用該介面前，已充分了解影片點播產品的收費方式和價格。影片點播中修改媒體資源儲存類型會產生儲存費用，計費詳情，請參見媒體資源儲存計費。
修改媒體資源儲存類型是一個非同步操作，整體完成後給使用者發送回呼。
若媒體資源目前的儲存類型為歸檔或冷歸檔，呼叫本介面會自動觸發解凍，解凍完成後修改儲存類型，不需要使用者手動呼叫 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

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
MediaIds	string	是	媒體 ID，即音訊/影片 ID（VideoId）。多個 ID 之間使用半形逗號（,）分隔，最多支援 20 個。可透過以下方式獲取：透過主控台上傳的音訊/影片，可登入點播主控台，選擇媒體資源庫 > 音訊/影片檢視音訊/影片 ID。透過獲取影音上傳地址和憑證介面獲取上傳地址和憑證時，為返回參數 VideoId 的值。音訊/影片上傳後，可透過搜尋媒體資訊介面查詢，為請求後返回參數 VideoId 的值。	d56c2ac0cee271ed80004710b5ba****
Scope	string	否	變更範圍，不傳則取預設值 All。取值： All（預設）：將整個媒體資源的資源（來源檔案和轉碼流）做分級儲存。 SourceFile：僅對媒體資源 ID 下的影片來源檔案做分級儲存，來源檔案之外的資源為標準儲存。	All
StorageClass	string	是	儲存類型。取值： Standard：標準 IA：低頻（Infrequent Access） Archive：歸檔 ColdArchive：冷歸檔	Archive
RestoreTier	string	否	解凍優先順序（僅冷歸檔媒體資源需要）。不傳則取預設值 Standard，取值： Expedited：高優先順序 Standard（預設）：標準 Bulk：批次	Standard
AllowUpdateWithoutTimeLimit	boolean	否	是否允許儲存時長不足的媒體資源進行儲存類型變更。取值： true：允許 false（預設）：不允許說明如果媒體資源儲存時長不足，強制進行儲存類型變更，會涉及額外的取回費用。	false

對於冷歸檔類型的媒體資源，您可以指定解凍天數和解凍優先順序，解凍天數最短為 1 天，最長為 365 天。不同解凍優先順序的取回時間如下：

高優先順序（Expedited）：表示 1 小時內完成解凍。
標準（Standard）：表示 2~5 小時內完成解凍。
批次（Bulk）：表示 5~12 小時內完成解凍。

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	30FA0B7C-3A81-5449-93CD-ACA149E6****
Status	string	任務狀態。取值： Processing：處理中。 Failed：失敗。	Processing
IgnoredList	object
MediaId	array	獲取失敗的媒體資源 ID 列表。
	string	獲取失敗的媒體資源 ID。	['19e231ee6e3e417fbf2e92ec2680****']
ForbiddenList	object
MediaForbiddenReasonDTO	array<object>	處理失敗的媒體資源 ID 列表。
	object	處理失敗媒體資源資訊。
MediaId	string	媒資 ID。	19e231ee6e3e417fbf2e92ec2680****
Reason	string	失敗原因。	TargetStorageClassInconsistent

樣本

正常返回樣本

JSON格式

{
  "RequestId": "30FA0B7C-3A81-5449-93CD-ACA149E6****",
  "Status": "Processing",
  "IgnoredList": {
    "MediaId": [
      "['19e231ee6e3e417fbf2e92ec2680****']"
    ]
  },
  "ForbiddenList": {
    "MediaForbiddenReasonDTO": [
      {
        "MediaId": "19e231ee6e3e417fbf2e92ec2680****",
        "Reason": "TargetStorageClassInconsistent"
      }
    ]
  }
}

錯誤碼

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

變更歷史

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