UpdateMediaStorageClass を使用したメディアアセットのストレージクラスの変更 - VOD - Alibaba Cloud - ApsaraVideo VOD

操作説明

この操作を使用する前に、ApsaraVideo VOD の課金方法と料金を完全に理解していることを確認してください。メディアアセットのストレージクラスを変更すると、ストレージ料金が発生します。請求明細の詳細については、「メディアアセットストレージの課金」を参照してください。
ストレージクラスの変更は非同期操作です。操作全体が完了した後、コールバックが送信されます。
メディアアセットの現在のストレージクラスが Archive または ColdArchive の場合、この操作を呼び出すと自動的に解凍がトリガーされます。解凍が完了すると、ストレージクラスが変更済みになります。RestoreMedia 操作を手動で呼び出してメディアアセットを解凍する必要はありません。ColdArchive メディアアセットの場合は、解凍優先度を指定する必要があります。デフォルト値は RestoreTier=Standard です。
変更中のメディアアセットは、再度変更したり、制作や処理に使用したりできません。
標準以外のストレージクラスのメディアアセットには、最小値の保存期間の要件があります。低頻度アクセス/ソースファイル低頻度アクセスは最低 30 日、アーカイブ/ソースファイルアーカイブは最低 60 日、コールドアーカイブストレージ/ソースファイルコールドアーカイブストレージは最低 180 日が必要です。保存期間が不足している場合、ストレージクラスを変更すると残りの日数分のストレージ料金が発生します。たとえば、保存 10 日後にストレージクラスを低頻度アクセスから標準に変更した場合、低頻度アクセスの残り 20 日分が課金され、合計で 30 日分の低頻度アクセスストレージ料金が発生します。
自己管理バケットのストレージクラスの変更はサポートされていません。

今すぐお試しください

この 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 (オーディオまたはビデオ ID (VideoId))。複数の ID はコンマ (,) で区切ります。最大 20 個の ID を指定できます。ID は以下の方法で取得できます。コンソールからアップロードされたオーディオまたはビデオファイルの場合、ApsaraVideo VOD コンソールにログインし、メディアファイル > オーディオ/ビデオを選択してオーディオまたはビデオ ID をビューに表示します。 CreateUploadVideo 操作を呼び出してアップロード URL と認証情報を取得する場合、ビデオ ID は VideoId レスポンスパラメーターの値です。オーディオまたはビデオファイルのアップロード後、 SearchMedia 操作を呼び出してビデオ ID をクエリできます。これは VideoId レスポンスパラメーターの値です。	d56c2ac0cee271ed80004710b5ba****
Scope	string	任意	変更の範囲。このパラメーターを指定しない場合、デフォルト値 All が使用されます。有効な値: All (デフォルト): メディアアセットのすべてのリソース (ソースファイルおよびトランスコード済みストリーム) に階層型ストレージを適用します。 SourceFile: メディアアセットのソースファイルにのみ階層型ストレージを適用します。ソースファイル以外のリソースは標準ストレージを使用します。	All。
StorageClass	string	必須	ストレージクラス。有効な値: Standard: 標準 IA: 低頻度アクセス Archive: アーカイブ ColdArchive: コールドアーカイブストレージ	Archive。
RestoreTier	string	任意	解凍優先度 (ColdArchive メディアアセットの場合のみ必須)。このパラメーターを指定しない場合、デフォルト値 Standard が使用されます。有効な値: Expedited: 高速 Standard (デフォルト): 標準 Bulk: 一括	標準
AllowUpdateWithoutTimeLimit	boolean	任意	最小値の保存期間の要件を満たしていないメディアアセットのストレージクラス変更を許可するかどうかを指定します。有効な値: true: 許可します。 false (デフォルト): 許可しません。説明メディアアセットの保存期間が不足している状態でストレージクラスの変更を強制すると、追加の取得料金が発生します。	false。

ColdArchive メディアアセットの場合、解凍持続時間と解凍優先度を指定できます。解凍持続時間は 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"
      }
    ]
  }
}

エラーコード

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

変更履歴

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