すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:キャッシュの更新およびプリフェッチ

最終更新日:Feb 11, 2026

オリジンサーバー上のコンテンツが更新された場合、または非準拠リソースを削除する必要がある場合、Content Delivery Network(CDN)のポイント・オブ・プレゼンス(POP)上のキャッシュをパージする必要があります。これにより、ユーザーが最新のコンテンツにアクセスできるようになります。イベント開催前や新規コンテンツの公開前に、リソースを CDN POP にプリフェッチすることで、初回訪問時の読み込み速度を大幅に向上させ、オリジンサーバーへの負荷を軽減できます。本トピックでは、ApsaraVideo VOD のキャッシュ更新およびリソースプリフェッチ機能の使用方法について説明します。

機能概要

リソースパージ

パージ操作は、ファイルを直接削除するのではなく、CDN POP に対してキャッシュ無効化コマンドを送信します。POP がこのコマンドを受信すると、該当するキャッシュ済みリソースを「無効」または「期限切れ」とマークします。次にユーザーがそのリソースを要求した際、POP は無効なキャッシュを検出し、オリジンサーバーから最新バージョンを取得してユーザーに提供するとともに、新しいバージョンを再キャッシュします。

シナリオ

  1. コンテンツの更新および公開: オリジンサーバー上のリソースを更新した後、対象の URL またはディレクトリをパージできます。これにより、ユーザーが古くなったキャッシュではなく最新バージョンのコンテンツを取得できるようになります。

  2. 非準拠コンテンツの削除: オリジンサーバーから非準拠コンテンツを削除した場合でも、CDN キャッシュ上に残っているため、依然としてアクセス可能になる可能性があります。URL パージ機能を使用してキャッシュをクリアし、コンテンツが完全に削除されることを保証できます。

リソースプリフェッチ

プリフェッチは、指定された URL リストに基づき、CDN POP がオリジンサーバーからリソースを取得してキャッシュするように促す処理です。これは、オリジンサーバーがコンテンツを能動的にプッシュするプロセスとは異なります。プリフェッチにより、新規リソースやキャンペーンページの初回訪問時の読み込み速度が向上し、高トラフィックイベント時のオリジンサーバーへの戻りトラフィック(back-to-origin traffic)を削減することで、オリジンサーバーを保護します。

シナリオ

  1. Alibaba Cloud CDN の導入時: Alibaba Cloud CDN を初めて利用開始する際、人気のある静的リソースを POP にプリフェッチできます。これにより、アクセス速度が向上し、ユーザー体験が向上します。

  2. キャンペーン支援: 大規模なキャンペーンを開始する前に、キャンペーンページ用のすべての静的リソースを CDN POP にプリフェッチできます。キャンペーン開始時に、POP がこれらのリソースに対するすべてのユーザー要求を直接応答するため、ページ読み込みが高速化されます。

  3. インストールパッケージまたは大容量ファイルの公開: 新しいソフトウェアバージョンまたはアップデートパッケージをリリースする前に、リソースを CDN POP にプリフェッチできます。正式リリース後、POP がユーザーのダウンロード要求を直接処理するため、ダウンロード速度が向上し、オリジンサーバーへの負荷が軽減されます。

前提条件

  • 実行タイミング: パージおよびプリフェッチタスクはオリジンサーバーへの戻りトラフィック(back-to-origin traffic)を発生させます。大規模なパージまたはプリフェッチタスクは、トラフィックが少ない時間帯に実行することを推奨します。

  • URL 形式: 提出する URL に中国語文字や空白などの非 ASCII 文字が含まれる場合、事前に UTF-8 でパーセントエンコーディングを実行する必要があります。

  • 共有キャッシュ: ドメイン名が共有キャッシュとして設定されている場合、プライマリドメイン名または関連付けられた任意のドメイン名を使用してパージタスクを提出すると、関連付けられたすべてのドメイン名のキャッシュが無効になります。

操作手順

リソースのパージ

  1. ApsaraVideo VOD コンソール にログインします。

  2. 左側ナビゲーションウィンドウで、[設定管理] > [CDN 設定] > [更新およびプリフェッチ] を選択します。

  3. [キャッシュのリフレッシュ] タブで、[操作タイプ] を [リフレッシュ] に設定します。

  4. 要件に応じて更新方法を選択し、タスクを提出します。

    更新方法

    説明

    URL

    目的: 1 つ以上の特定ファイルのキャッシュをパージします。

    操作: URL テキストボックスに、http:// または https:// を含む完全な URL を入力します。1 行に 1 つの URL を入力します。例: https://www.example.com/static/image.jpg

    フォルダー

    目的: CDN ディレクトリ内のすべてのファイルおよびサブディレクトリのキャッシュをパージします。

    操作: 完全なディレクトリ URL を入力し、末尾に / を付けることを確認します。例: https://www.example.com/static/

    注意: これは更新ベースのパージです。ディレクトリ全体を強制的にパージするには、「キャッシュの更新」を使用し、Force=true を設定します。

  5. 送信 をクリックします。システムがパージタスクの実行を開始します。

    説明
    • パージタスクは提出後に中止できません。

    • パージタスクは、ネットワーク全体で有効になるまで通常 5~6 分かかります。キャッシュの生存時間(TTL)がこの期間より短い場合は、手動でのパージは不要です。

リソースのプリフェッチ

  1. ApsaraVideo VOD コンソール にログインします。

  2. 左側ナビゲーションウィンドウで、[設定管理] > [CDN 設定] > [更新およびプリフェッチ] を選択します。

  3. キャッシュのリフレッシュ タブで、[操作タイプ] を プッシュ に設定します。

  4. URL テキストボックスに、プリフェッチするファイルの完全な URL を入力します。1 行に 1 つの URL を入力します。ディレクトリのプリフェッチはできません。例: https://www.example.com/install/package.zip

  5. 送信 をクリックします。システムがプリフェッチタスクの実行を開始します。

    説明
    • プリフェッチタスクは提出後に中止できません。

    • プリフェッチタスクの完了に要する時間は、ファイルサイズ、ファイル数、オリジンサーバーのパフォーマンスによって異なります。通常は 5~30 分かかります。

検証結果

  • 手動クエリ

    [操作記録] タブで、パージまたはプリフェッチタスクの詳細および進捗状況を確認できます。進捗が 100% になると、タスクが完了したことを示します。多数のリソースをパージまたはプリフェッチする場合、タスクの完了に時間がかかることがあります。タスクが完了するまでお待ちください。

  • API クエリ

    GetMediaRefreshJobs 操作を呼び出して、パージまたはプリフェッチタスクのステータスを確認できます。

  • コマンドラインによる検証

    curl -I <resource_URL> コマンドを実行します。出力は以下のようになります。

    image

    X-Cache ヘッダーが存在する場合:

    • X-CacheHIT の場合、キャッシュがヒットし、プリフェッチが成功しています。

    • X-CacheMISS の場合、キャッシュがミスしています。これは、プリフェッチタスクが未完了または失敗したことを示します。リソースを再度プリフェッチしてください。

    X-Cache ヘッダーが存在しない場合:

    X-Cache ヘッダーが存在しない場合、リソースは CDN に追加されていません。「ドメイン名の追加」の手順に従って、URL のドメイン名を設定した後、リソースをプリフェッチしてください。

制限事項

操作タイプ

方法

クォータ制限

更新

URL パージ

各アカウントは 1 日あたり最大 2,000 件のエントリを提出でき、1 回のリクエストあたり最大 1,000 件のエントリを提出できます。

ディレクトリ更新

各アカウントは 1 日あたり最大 100 回のリクエスト、1 回のリクエストあたり最大 100 件の項目が許可されます。

プリフェッチ

URL プリフェッチ

各アカウントは 1 日あたり最大 500 件、1 回のリクエストあたり最大 100 件の項目を提出できます。

課金

キャッシュの更新およびプリフェッチ機能は無料です。

ただし、両方の操作は CDN エッジ POP がオリジンサーバーからリソースをプルすることをトリガーします。これにより、オリジンサーバーへの戻りトラフィック(back-to-origin traffic)およびオリジンリクエストに関する課金が発生します。課金基準は、使用するオリジンサーバーの種類によって異なります:

重要

大規模なパージまたはプリフェッチ操作、特に短期間で実行される操作は、オリジンサーバーへの戻りトラフィック(back-to-origin traffic)のコスト増加を招く可能性があります。これらの操作を実行する前に、潜在的なコスト影響を評価してください。

関連 API

よくある質問