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

CDN:リソースの更新とプリフェッチ

最終更新日:Nov 09, 2025

更新機能を使用すると、コンテンツ配信ネットワーク (CDN) のポイントオブプレゼンス (POP) 上のキャッシュされたリソースを削除できます。これにより、POP はオリジンサーバーから最新のリソースを取得するよう強制されます。この機能を使用して、オリジンリソースの更新や公開、非準拠コンテンツの削除、ドメイン名設定の変更の適用ができます。プリフェッチ機能を使用すると、ピークトラフィック時間前に CDN POP に人気のあるリソースをキャッシュできます。これにより、オリジンサーバーの負荷が軽減されます。

機能紹介

リソースの更新

更新操作は、キャッシュ無効化命令を CDN POP に送信します。ファイルを直接削除するわけではありません。POP が命令を受信すると、一致するキャッシュされたリソースを「無効」または「期限切れ」としてマークします。ユーザーが再度リソースをリクエストすると、POP はキャッシュが無効であると判断します。その後、オリジンサーバーから最新のリソースを取得し、ユーザーに返して再度キャッシュします。

シナリオ

  1. リソースの更新と公開: オリジンサーバー上のリソースを更新またはアップグレードした後、リソースの URL またはディレクトリを更新のために送信できます。これにより、ユーザーは最新のリソースにアクセスでき、それらのリソースは CDN POP にキャッシュされます。これにより、ユーザーが古いキャッシュされたリソースにアクセスするのを防ぎます。

  2. 非準拠リソースの削除: オリジンサーバーに「制限」で言及されているような非準拠コンテンツがある場合、オリジンサーバーから削除しても CDN POP にキャッシュされているため、コンテンツにアクセスできる可能性があります。URL 更新機能を使用してキャッシュされたリソースを更新し、非準拠コンテンツが迅速に削除されるようにすることができます。

リソースのプリフェッチ

プリフェッチ操作は、CDN POP がオリジンサーバーからリソースを積極的にリクエストしてキャッシュするように促します。オリジンサーバーはリソースを積極的にプッシュしません。プリフェッチは、新しいリソースやイベントページの初回アクセス速度を向上させます。また、イベントが公開されたときに back-to-origin のプレッシャーを軽減し、オリジンサーバーを保護します。

シナリオ

  1. Alibaba Cloud CDN の初回使用: 初めて CDN を使用する場合、人気のある静的リソースを CDN POP にプリフェッチできます。ユーザーがリクエストを行うと、POP は直接応答できます。これにより、初回アクセス速度の低下を回避し、ユーザーエクスペリエンスを向上させます。

  2. 運用活動: 大規模なイベントの場合、イベントページの静的リソースを事前に CDN POP にプリフェッチできます。イベントが開始されると、ユーザーからリクエストされたすべての静的リソースはすでに POP にキャッシュされています。POP は直接応答するため、イベントページが迅速に読み込まれるようになります。

  3. インストールパッケージまたはその他の大きなファイルのリリース: インストールまたはアップグレードパッケージの新しいバージョンをリリースする前に、リソースを CDN POP にプリフェッチできます。プロダクトが正式にリリースされた後、ユーザーからのダウンロードリクエストは POP によって直接処理されます。これにより、ダウンロード速度が向上し、オリジンサーバーの負荷が軽減されます。

前提条件

  • 権限要件: Resource Access Management (RAM) ユーザーを使用して操作を実行する場合、まず cdn:PushObjectCache (プリフェッチ) および cdn:RefreshObjectCaches (パージ) 権限を付与する必要があります。詳細については、「RAM ユーザーにパージとプリフェッチの権限を付与する」をご参照ください。

  • URL フォーマット: 送信する URL に中国語文字やスペースなどの非 ASCII 文字が含まれている場合は、まず URL を UTF-8 形式でパーセントエンコードする必要があります。

注意

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

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

  • アクセス URL の書き換え: ドメイン名がアクセス URL の書き換えで設定されている場合、CDN ノードは書き換えられた URL を使用してキャッシュキーを生成します。したがって、更新およびプリフェッチ操作には書き換えられた URL を送信する必要があります。

課金の説明

更新およびプリフェッチ機能は無料です。

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

  • オリジンサーバーが OSS の場合、OSS の課金ルールに従ってトラフィック料金リクエスト料金が請求されます。

  • オリジンサーバーが ECS インスタンスまたは別のサーバーの場合、そのネットワーク帯域幅またはトラフィックに基づいて課金されます。

重要

大規模な更新またはプリフェッチ操作、特に短期間に行うと、back-to-origin コストが増加する可能性があります。これらの操作を実行する前に、潜在的なコストへの影響を評価することをお勧めします。

ユーザーガイド

リソースの更新

  1. Alibaba Cloud CDN コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、パージとプリフェッチ をクリックします。

  3. パージ / プリフェッチ タブで、[操作タイプ] を [更新] に設定します。

  4. 更新方法を選択してタスクを送信します。

    更新方法

    説明

    URL 更新

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

    アクション: [更新コンテンツ] テキストボックスに、完全な URL を 1 行に 1 つずつ入力します。URL は http:// または https:// で始まる必要があります。例: https://www.example.com/static/image.jpg

    ディレクトリ更新

    目的: 指定された URL ディレクトリ以下のすべてのファイルとサブディレクトリのキャッシュを無効にします。

    アクション: 完全なディレクトリ URL を入力します。URL は / で終わる必要があります。例: https://www.example.com/static/

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

    正規表現更新

    目的: URL パスが正規表現に一致するリソースのキャッシュをバッチで無効にします。

    アクション: 正規表現を含む URL を入力します。例: すべての .jpg 画像を更新する場合: https://www.example.com/static/.*\.(jpg)

    注: この方法はパージのマークです。フォルダ全体を強制的にパージするには、キャッシュ更新 API を使用し、Force=true を設定します。

    注意: 意図しない大規模なキャッシュ無効化を避けるために、より正確な一致ルールを使用してください。たとえば、/images/ ディレクトリ内のすべての .png ファイルのみを更新するには、https://www.example.com/.* の代わりに https://www.example.com/images/.*\.png を使用します。

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

    説明
    • 更新タスクは送信後に中止できません。

    • 更新タスクは通常、ネットワーク全体で有効になるまでに 5〜6 分かかります。キャッシュの有効期限がこれより短い場合は、手動で更新する必要はありません。

    • OSS コンソールで自動 CDN キャッシュ更新を有効にしている場合、OSS の自動キャッシュ更新タスクを CDN コンソールで表示することはできません。

リソースのプリフェッチ

  1. Alibaba Cloud CDN コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、パージとプリフェッチ をクリックします。

  3. パージ / プリフェッチ タブで、[操作タイプ] を [プリフェッチ] に設定します。

  4. [プリフェッチコンテンツ] テキストボックスに、プリフェッチするファイルの完全な URL を 1 行に 1 つずつ入力します。ディレクトリのプリフェッチはサポートされていません。例: https://www.example.com/install/package.zip

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

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

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

自動更新またはプリフェッチ

次の問題が発生した場合は、スクリプトを使用した自動パージとプリフェッチを使用することをお勧めします:

  • 開発者がおらず、手動で更新およびプリフェッチタスクを送信する必要がある。これにより、O&M コストが高くなります。

  • 更新またはプリフェッチする URL が多すぎて、バッチで送信するのが非効率です。

  • 更新およびプリフェッチタスクが期待どおりに実行されているかどうかを確認するために手動またはプログラムによるチェックが必要であり、時間がかかり、手間がかかります。

結果の確認

  • 手動クエリ

    操作記録タブで、リソースのパージまたはプリフェッチタスクの詳細な記録と進捗状況を表示できます。進捗が 100% の場合、タスクは完了しています。多くのパージまたはプリフェッチタスクは、タスクの完了進捗に影響を与える可能性があります。しばらくお待ちください。

    image

  • API クエリ

    詳細については、「DescribeRefreshTaskById」をご参照ください。API 操作を呼び出して、パージまたはプリフェッチタスクが完了したかどうかをクエリできます。

  • コマンドライン検証

    curl -I <リソース URL> コマンドを実行します。システムは次の結果を表示します:

    image

    X-Cache が存在する場合:

    • X-CacheHIT: リクエストがキャッシュにヒットしました。プリフェッチは成功しました。

    • X-CacheMISS: リクエストがキャッシュにヒットしませんでした。プリフェッチタスクが完了していないか、失敗しています。リソースを再度プリフェッチしてください。

    X-Cache が存在しない場合:

    X-Cache ヘッダーが存在しない場合、リソースが CDN に追加されていないことを示します。詳細については、「Alibaba Cloud CDN とのクイック統合」をご参照ください。URL のドメイン名を Alibaba Cloud CDN に追加してから、リソースをプリフェッチしてください。

制限

操作タイプ

メソッド

クォータ制限

クォータの管理

更新

URL 更新

アカウントあたり 1 日最大 10,000 件

クォータ管理

ディレクトリ更新

1 回の送信あたり最大 100 件。ドメイン名あたり 1 分あたり最大 100 件。

正規表現更新

アカウントあたり 1 日最大 20 件

プリフェッチ

URL プリフェッチ

1 回の送信あたり最大 100 件。アカウントあたり 1 日最大 1,000 件。

参考情報: CDN キャッシュ更新メカニズム

CDN は、ディレクトリ更新と正規表現更新のために、マーク付き更新と強制更新の 2 つのキャッシュ更新メカニズムを提供します。これらは、キャッシュされたコンテンツを柔軟かつ効率的に管理するのに役立つさまざまなシナリオに適用されます。

マーク付き更新 (デフォルトの CDN ポリシー)

  • シナリオ: 静的ファイルの新しいバージョンの公開など、定期的なコンテンツの更新。

  • メカニズム: これは、コンソールでのディレクトリ更新と正規表現更新のデフォルトの動作です。CDN POP がオリジンからリソースを取得するとき、If-Modified-Since または If-None-Match リクエストヘッダーを含みます。オリジンサーバーは、これらのヘッダーに基づいてリソースが更新されたかどうかを判断します。

  • 効果: オリジンサーバー上のリソースが変更されていない場合、オリジンサーバーは 304 Not Modified ステータスコードを返します。CDN POP は古いキャッシュコピーを引き続き使用し、back-to-origin トラフィックを消費しません。これは、コストとオリジンサーバーリソースを節約するための最適化された方法です。

強制更新

  • シナリオ: 非準拠または不正確なリソースの緊急削除、または不正確な Cache-Control 応答ヘッダー設定を修正した後のネットワーク全体の強制更新。

  • メカニズム: このモードは、キャッシュ更新 API を使用して更新タスクを送信し、Force パラメーターを true に設定するとトリガーされます。このモードでは、CDN のポイントオブプレゼンス (POP) は、キャッシュされたリソースを無条件に無効としてマークします。

  • 効果: 次にリソースにアクセスするとき、オリジンサーバー上のファイルが変更されていなくても、CDN POP はオリジンから新しいバージョンを取得する必要があります。

よくある質問

関連 API 操作

API 操作を呼び出して、リソースをパージおよびプリフェッチできます。詳細については、「パージおよびプリフェッチ API」をご参照ください。