すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:RefreshMediaPlayUrls

    ドキュメントセンター

    ApsaraVideo VOD:RefreshMediaPlayUrls

    最終更新日:Jul 21, 2026

    音声または動画 ID を指定して、音声または動画ファイルのリフレッシュまたはプリフェッチタスクを送信します。

    操作説明

    • ApsaraVideo VOD はリソースのパージおよびプリフェッチの特徴を提供します。パージの特徴は、ポイントオブプレゼンス上のキャッシュされたリソースを削除し、ポイントオブプレゼンスがオリジンサーバーへの back-to-origin リクエストを通じて最新のリソースを取得するように強制します。プリフェッチの特徴を使用すると、ピーク時間帯の前に人気のあるリソースをポイントオブプレゼンスにダウンロードしてキャッシュでき、アクセス効率が向上します。

    • この操作では、音声または動画 ID によってリフレッシュまたはプリフェッチノードを直接送信し、ストリーミングフォーマットおよび解像度によるフィルタリングをサポートしているため、必要に応じて特定のストリームをリフレッシュまたはプリフェッチできます。

    • 一度に最大 20 個の音声または動画ファイルに対してリフレッシュまたはプリフェッチノードを送信できます。

    QPS 制限

    この操作における単一ユーザーの QPS 制限は、毎秒 50 回の呼び出しです。制限を超えると、API の呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。この操作は適切に呼び出してください。詳細については、「QPS 制限」を参照してください。

    今すぐお試しください

    この 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:RefreshMediaPlayUrls

    update

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    MediaIds

    string

    必須

    リフレッシュまたはプリフェッチする音声または動画ファイルの ID。1 つ以上の ID を指定できます。複数の ID はコンマ (,) で区切ります。最大 20 個の ID を指定できます。 以下の方法で音声または動画 ID を取得できます。

    • コンソールからアップロードされた音声または動画ファイルの場合、ApsaraVideo VOD コンソール にログインし、メディアファイル > 音声/動画 を選択して音声または動画 ID をビューで確認します。

    • CreateUploadVideo 操作を呼び出してアップロード URL と認証情報を取得する場合、音声または動画 ID は VideoId レスポンスパラメーターの値です。

    • 音声または動画ファイルのアップロード後、 SearchMedia 操作を呼び出して音声または動画 ID をクエリできます。これは VideoId レスポンスパラメーターの値です。

    ca3a8f6e4957b658067095869****, a6e49sfgd23p5g9ja7095863****
    TaskType

    string

    必須

    タスクのタイプ。有効な値:

    • Refresh: パージ。

    • Preload: プリフェッチ。

    Preload。
    Formats

    string

    任意

    リフレッシュまたはプリフェッチするストリーミングフォーマット。複数のフォーマットを指定できます。複数のフォーマットはコンマ (,) で区切ります。このパラメーターを指定しない場合、デフォルトですべてのフォーマットのストリームがリフレッシュまたはプリフェッチされます。有効な値:

    • mp4

    • m3u8

    • mp3

    • flv

    • webm

    • ts

    mp4,m3u8
    Definitions

    string

    任意

    パージまたはプリフェッチするストリームの解像度を指定します。複数の解像度を指定できます。複数の解像度はコンマ (,) で区切ります。このパラメーターを指定しない場合、デフォルトですべての解像度のストリームがパージまたはプリフェッチされます。

    説明

    値は、「メディアアセットのメトリックの説明」の Definition で定義された値のいずれかである必要があります。

    HD, SD
    StreamType

    string

    任意

    リフレッシュまたはプリフェッチするストリームのタイプ。複数のストリームタイプを指定できます。複数のストリームタイプはコンマ (,) で区切ります。このパラメーターを指定しない場合、デフォルトですべてのストリームタイプがリフレッシュまたはプリフェッチされます。有効な値:

    • video: 動画。

    • audio: 音声。

    video。
    ResultType

    string

    任意

    リフレッシュまたはプリフェッチタスクの結果タイプ。有効な値:

    • Single (デフォルト): 各解像度およびフォーマットの最新のトランスコード済みストリームのみがリフレッシュまたはプリフェッチされます。

    • Multiple: 各解像度およびフォーマットのすべてのトランスコード済みストリームがリフレッシュまたはプリフェッチされます。

    Single。
    SliceFlag

    boolean

    任意

    M3U8 ストリーム内の TS ファイルの再生 URL をリフレッシュまたはプリフェッチするかどうかを指定します。有効な値:

    • false (デフォルト): いいえ。

    • true: はい。

    false。
    SliceCount

    integer

    任意

    M3U8 ストリームに対してリフレッシュまたはプリフェッチする TS ファイル再生 URL の数。各 M3U8 ストリームの最初の N 個の TS ファイル再生 URL のみがリフレッシュまたはプリフェッチされます。有効な値: 1～20。デフォルト値: 5。

    5
    UserData

    string

    任意

    カスタム設定。値は JSON フォーマットの文字列で、メッセージコールバックやアップロード高速化などの設定をサポートします。詳細については、「 UserData 」を参照してください。

    説明

    • このパラメーターでメッセージコールバックを使用するには、コンソールで HTTP コールバック URL を設定し、対応するコールバックイベントタイプを選択する必要があります。そうしないと、コールバック設定は効果を持ちません。コンソールで HTTP コールバックを設定する方法については、「コールバック設定」を参照してください。

    • アップロード高速化の特徴を使用するには、チケットを提出して有効化してください。詳細については、「アップロード手順」を参照してください。チケットの提出方法については、「お問い合わせ」を参照してください。

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    MediaRefreshJobId

    string

    リフレッシュまたはプリフェッチタスクの ID。

    41d465e31957****
    NonExistMediaIds

    string

    存在しない音声または動画 ID のリスト。

    ca3a8f6e4957b658067095869****
    ForbiddenMediaIds

    string

    禁止されている音声または動画 ID のリスト。通常、マルチアプリケーション権限がないことが原因です。詳細については、「マルチアプリケーション」を参照してください。

    a6e49sfgd23p5g9ja7095863****
    RequestId

    string

    リクエスト ID。

    25818875-5F78-4AF6-04D5-D7393642****

    例

    成功レスポンス

    JSONJSON

    {
  "MediaRefreshJobId": "41d465e31957****",
  "NonExistMediaIds": "ca3a8f6e4957b658067095869****",
  "ForbiddenMediaIds": "a6e49sfgd23p5g9ja7095863****",
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****"
}

    エラーコード

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

    変更履歴

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