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

ApsaraVideo VOD:パージとプリフェッチ

最終更新日:Aug 28, 2026

オリジンサーバーのコンテンツが更新された場合、またはコンプライアンスに違反するリソースを削除する必要がある場合は、コンテンツデリバリーネットワーク (CDN) の POP (Point of Presence) のキャッシュをパージする必要があります。これにより、ユーザーは最新のコンテンツに確実にアクセスできます。イベントや新しいコンテンツの公開前にリソースを CDN POP にプリフェッチすることで、ユーザーの初回アクセス速度を大幅に向上させ、オリジンサーバーの負荷を軽減できます。このトピックでは、ApsaraVideo VOD のキャッシュのパージおよびリソースのプリフェッチ機能の使用方法について説明します。

仕組み

リソースのパージ

パージ操作は、ファイルを直接削除するのではなく、キャッシュの無効化コマンドを CDN POP に送信します。POP はコマンドを受信すると、一致するキャッシュされたリソースを「無効」または「期限切れ」としてマークします。次にユーザーがリソースをリクエストすると、POP は無効なキャッシュを検出し、オリジンサーバーから最新バージョンを取得してユーザーに提供すると同時に、再キャッシュします。

ユースケース

  1. コンテンツの更新とリリース:オリジンサーバー上のリソースを更新した後、それらをパージして、ユーザーが確実に最新バージョンを受信できるようにします。その後、コンテンツは POP に再キャッシュされます。

  2. コンプライアンスに違反するコンテンツの削除:オリジンサーバーにコンプライアンスに違反するコンテンツが含まれている場合、ソースファイルを削除した後でも CDN キャッシュに残ることがあります。URL パージ機能を使用して、キャッシュからリソースをクリアします。

リソースのプリフェッチ

プリフェッチ操作は、提供された URL リストに基づいて、オリジンサーバーからリソースを事前に取得してキャッシュするように CDN POP に指示します。これはオリジンサーバーからの「プッシュ」モデルではなく、「プル」モデルです。プリフェッチにより、初回読み込み速度が向上し、高トラフィックイベント中のオリジンフェッチの負荷が軽減され、オリジンサーバーの保護に役立ちます。

ユースケース

  1. Alibaba Cloud CDN へのオンボード:新しいドメインを Alibaba Cloud CDN に追加する際、よくアクセスされる静的リソースを POP にプリフェッチします。これにより、最初のユーザーリクエストがキャッシュから直接提供されるため、読み込み時間が遅くなるのを防ぎ、ユーザーエクスペリエンスが向上します。

  2. プロモーションキャンペーンのサポート:大規模なキャンペーンの場合、イベントページの静的リソースを事前に POP にプリフェッチします。キャンペーンが開始されると、これらの静的リソースに対するすべてのユーザーリクエストは POP から直接提供され、高速なページ読み込みが保証されます。

  3. インストールパッケージや大規模ファイルの公開:新しいソフトウェア、インストールパッケージ、またはその他の大規模ファイルをリリースする前に、それらを POP にプリフェッチします。公開後、大量のダウンロードリクエストは CDN キャッシュから直接提供されます。これにより、ダウンロード速度が向上し、オリジンサーバーの負荷が軽減され、ユーザーエクスペリエンスが向上します。

前提条件

  • タイミング: パージおよびプリフェッチタスクは back-to-origin トラフィックを生成します。大規模なパージまたはプリフェッチタスクは、オフピーク時に実行することを推奨します。

  • 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/

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

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

    説明
    • 送信後のパージタスクは中止できません。

    • パージタスクがネットワーク全体で有効になるまでには、通常 5〜6 分かかります。キャッシュの TTL (Time-To-Live) がこの期間より短い場合、手動でキャッシュをパージする必要はありません。

リソースのプリフェッチ

  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 API を呼び出して、パージまたはプリフェッチタスクのステータスを確認できます。

  • コマンドラインでの検証

    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 アカウントあたり 1 日に最大 500 件、1 リクエストあたり最大 100 件を送信できます。

課金

パージおよびプリフェッチ機能は 無料 です。

ただし、どちらの操作も CDN エッジ POP がオリジンサーバーからリソースをプルするトリガーとなります。これにより、back-to-origin トラフィックとオリジンリクエストのコストが発生します。課金基準は、使用するオリジンサーバーのタイプによって異なります。

重要

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

関連 API

よくある質問