パラメーターフィルタリングを有効にすると、Alibaba Cloud CDN の POP (Point of Presence) は、リクエスト URL 内の疑問符 (?) 以降のパラメーターを削除します。これらのパラメーターには、ユーザー ID やアクセスチャネルなどの情報が含まれる場合があります。CDN は、結果として得られる URL を使用してキャッシュハッシュキーを生成します。このプロセスにより、キャッシュヒット率が向上し、コンテンツ配信が高速化されます。このトピックでは、パラメーターフィルタリングの設定方法について説明します。
機能の比較
カスタムキャッシュキーはパラメータ無視と競合します。パラメータ無視とカスタムキャッシュキーの両方を同時に設定した場合、パラメータ無視は無効になります。
カスタムキャッシュキーは、キャッシュキーの設定においてパラメータ無視を置き換えることができ、より包括的な機能を提供します。最初にカスタムキャッシュキーを使用することを推奨します。設定の比較：
シナリオ
パラメータ無視
カスタムキャッシュキー
キャッシュキーからすべてのリクエストパラメータを無視
[パラメータ無視] を [はい] に設定し、[指定パラメータの保持] を空のままにします。
リクエストパラメータ処理ルールを追加します：
アクション：保持
パラメータ名：存在しない任意のパラメータ名 (example-argument など) を設定します。
キャッシュキーにリクエストパラメータ key1 のみを保持
[パラメータ無視] を [はい] に設定し、[指定パラメータの保持] を
key1に設定します。リクエストパラメータ処理ルールを追加します：
アクション：保持
パラメータ名：key1
キャッシュキーからリクエストパラメータ key1 のみを削除
key1のパラメータ設定を削除します。リクエストパラメータ処理ルールを追加します：
アクション：削除
パラメータ名：key1
オリジンパラメータの書き換えは、オリジンリクエストの書き換えにおいてパラメータ無視を置き換えることができ、より包括的な機能を提供します。最初に「オリジンパラメータの書き換え」を使用することを推奨します。
機能の概要
パラメータ無視
機能 | シナリオ |
リクエスト URL からクエリパラメーター ( | URL パラメータがリソースコンテンツと関連しない場合 (ユーザー UID、参照元、プロモーションコードなど) は、パラメータ無視を有効にします。たとえば、次の2つのリクエストは同じリソースにアクセスしますが、異なる UID を持っています： ユーザー A： ユーザー B： パラメータ無視を設定しない場合、CDN エッジノードはこれらを異なるリソースとして扱い、同じキャッシュを共有できないため、各リクエストに対してオリジンフェッチが必要になります。パラメータ無視を有効にすると、CDN エッジノードはパラメータを削除し、 |
URL 署名はパラメータ無視よりも優先されます。タイプ A 署名は、署名に URL パラメータを含めます。CDN は最初に認証を実行し、検証が成功した後にのみキャッシュコピーとして保存します。
オリジンパラメータの保持
機能 | シナリオ |
オリジンフェッチ時にすべての元の URL パラメータを保持し、オリジンサーバーが重要なユーザー情報を受信できるようにします。 | パラメータ無視が有効になっている場合、CDN エッジノードはデフォルトでパラメータを削除した URL を使用してオリジンフェッチを行います。上記の例では、ユーザー A とユーザー B の両方が |
操作手順
ApsaraVideo VOD コンソールにログインします。
左側のナビゲーションウィンドウで、[設定管理]> [CDN設定]> [ドメイン名] を選択します。
「ドメイン名」ページで、管理するドメイン名を見つけ、操作 列の [設定] をクリックします。
左側のナビゲーションペインで、パフォーマンスの最適化 をクリックします。
「パラメーターの無視」セクションで、変更をクリックします。
フィルターパターンやフィルタリングパラメーターなど、必要な設定項目を設定します。
次の表で各パラメーターについて説明します。
重要フィルターパターンを切り替えると、現在の設定は削除されます。
フィルターパターン：指定パラメーターを保持
パラメーター
説明
例
[パラメーターを無視]
はい: パラメーターフィルタリングを有効にします。オリジンフェッチリクエストの場合、URL 内の疑問符 (
?) 以降のパラメーターが削除されます。説明[パラメーターを無視] をオンにし、[指定したパラメーターを保持] を空のままにした場合、疑問符 (
?) 以降のすべてのパラメーターが削除されます。[いいえ]：パラメーターの無視機能を無効にします。
元の URL が
http://example.com/1.jpg?key1=1&key2=2&key3=3の場合、各設定での CDN による URL 処理の例は次のとおりです：例 1：すべてのパラメーターをフィルタリングし、処理後の URL をオリジンフェッチに使用：
設定： [パラメーターの無視] を [はい] に設定し、[指定パラメーターを保持] を空のままにし、[オリジンパラメーターを保持] を [いいえ] に設定します。
キャッシュキー：
http://example.com/1.jpgオリジンフェッチ URL：
http://example.com/1.jpg
例 2：指定パラメーターを保持し、処理後の URL をオリジンフェッチに使用：
設定： [パラメーターの無視] を [はい] に設定し、[指定パラメーターを保持] を
key1に設定し、[オリジンパラメーターを保持] を [いいえ] に設定します。キャッシュキー：
http://example.com/1.jpg?key1=1オリジンフェッチ URL：
http://example.com/1.jpg?key1=1
例 3：すべてのパラメーターをフィルタリングし、オリジンフェッチに元の URL を使用：
設定： [パラメーターの無視] を [はい] に設定し、[指定パラメーターを保持] を空のままにし、[オリジンパラメーターを保持] を [はい] に設定します。
キャッシュキー：
http://example.com/1.jpgオリジンフェッチ URL：
http://example.com/1.jpg?key1=1&key2=2&key3=3
例 4：指定パラメーターを保持し、オリジンフェッチに元の URL を使用：
設定： [パラメーターの無視] を [はい] に設定し、[指定パラメーターを保持] を
key1に設定し、[オリジンパラメーターを保持] を [はい] に設定します。キャッシュキー：
http://example.com/1.jpg?key1=1オリジンフェッチ URL：
http://example.com/1.jpg?key1=1&key2=2&key3=3
[指定されたパラメーターを保持]
保持するパラメーターを指定します。最大 10 個のパラメーターを指定できます。複数のパラメーターはコンマ (,) で区切ります。
[オリジンパラメーターの保持]
[はい]：オリジンフェッチリクエストで、元のリクエスト URL のすべてのパラメーターを保持します。
[いいえ]：オリジンフェッチリクエストのパラメーターは、キャッシュハッシュキーのパラメーターと同じです。つまり、指定されたパラメーターのみが保持されます。
フィルターパターン：指定パラメーターを削除
パラメーター
説明
例
指定パラメーターを削除
削除するパラメーターを指定します。最大 10 個のパラメーターを指定できます。複数のパラメーターはスペースで区切ります。
元の URL が
http://example.com/1.jpg?key1=1&key2=2&key3=3の場合、各設定での CDN による URL 処理の例は次のとおりです：例 1：指定パラメーターを削除し、処理後の URL をオリジンフェッチに使用：
設定： [指定パラメーターを削除] を
key1に設定し、[オリジンパラメーターを保持] を [いいえ] に設定します。キャッシュキー：
http://example.com/1.jpg?key2=2&key3=3オリジンフェッチ URL：
http://example.com/1.jpg?key2=2&key3=3
例 2：指定パラメーターを削除し、オリジンフェッチに元の URL を使用：
設定： [指定パラメーターを削除] を
key1に設定し、[オリジンパラメーターを保持] を [はい] に設定します。キャッシュキー：
http://example.com/1.jpg?key2=2&key3=3オリジンフェッチ URL：
http://example.com/1.jpg?key1=1&key2=2&key3=3
[オリジンパラメーターの保持]
[はい]：オリジンフェッチリクエストで、元のリクエスト URL のすべてのパラメーターを保持します。
[いいえ]：オリジンフェッチリクエストのパラメーターは、キャッシュハッシュキーのパラメーターと同じです。つまり、指定されたパラメーターが削除されます。
決定 をクリックします。