UpdateMediaStorageClass - - Alibaba Cloud ドキュメントセンター

操作説明

この操作は非同期操作です。この操作を呼び出して、メディアアセットのストレージクラスを変更できます。ストレージクラスが変更されると、コールバック通知が送信されます。
メディアアセットのストレージクラスがアーカイブまたはコールドアーカイブの場合、この操作を呼び出してメディアアセットのストレージクラスを変更すると、ストレージクラスが変更される前にメディアアセットが自動的に解凍されます。RestoreMedia 操作を呼び出してメディアアセットを解凍する必要はありません。コールドアーカイブオブジェクトの解凍優先度を指定する必要があります。デフォルト設定： RestoreTier=Standard。
ストレージクラスが変更中のメディアアセットは、使用または処理できません。
標準ストレージ以外のオブジェクトには、最低ストレージ期間があります。オブジェクトの保存期間が最低ストレージ期間より短い場合、オブジェクトのストレージクラスは変更できません。さまざまなストレージクラスのオブジェクトの最低ストレージ期間は次のとおりです：ソースファイルの IA (低頻度アクセス) または IA ストレージ： 30 日、ソースファイルのアーカイブまたはアーカイブストレージ： 60 日、ソースファイルのコールドアーカイブまたはコールドアーカイブストレージ： 180 日。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vod:UpdateMediaStorageClass

update

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
MediaIds	string	必須	メディアアセット ID。最大 20 個の ID を指定できます。複数の ID はコンマ (,) で区切ります。次のいずれかの方法で ID を取得できます： ApsaraVideo VOD コンソールにログインします。左側のナビゲーションウィンドウで、[メディアファイル] > [オーディオ/ビデオ] を選択します。「ビデオとオーディオ」ページで、メディアアセットの ID を表示できます。この方法は、ApsaraVideo VOD コンソールを使用してアップロードされたファイルに適用できます。メディアアセットのアップロードのために呼び出す CreateUploadVideo 操作のレスポンスから VideoId パラメーターの値を取得します。メディアアセットがアップロードされた後、メディア ID をクエリするために呼び出す SearchMedia 操作のレスポンスから VideoId パラメーターの値を取得します。	d56c2ac0cee271ed80004710b5ba****
Scope	string	任意	変更範囲。有効値： All：ソースファイルとトランスコードされたストリームを含むすべてのリソースのストレージクラスを変更します。 SourceFile：ソースファイルのストレージクラスのみを変更します。他のリソースのストレージクラスは標準です。	All
StorageClass	string	必須	ストレージクラス。有効値： Standard IA Archive ColdArchive	Archive
RestoreTier	string	任意	解凍優先度。このパラメーターは、コールドアーカイブのメディアアセットを解凍する場合にのみ必要です。有効値： 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

例

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。