パラメータフィルタリングを有効にすると、Points of Presence(POP)は、リクエスト URL 内の疑問符(?
)以降のパラメータを削除します。 これらのパラメータには、ユーザー ID やリクエストソースなどの情報が含まれています。元の URL はキャッシュキーとして使用されます。このトピックでは、パラメータフィルタリングを構成する方法について説明します。
カスタム CacheKey とパラメータフィルタリング機能は、一緒に使用すると競合します。パラメータフィルタリングを有効にすると、Points of Presence(POP)は、リクエスト URL 内の疑問符(?
)以降のパラメータを削除します。これにより、CacheKey 内のリクエストパラメータが無効になります。そのため、パラメータを変更する前に、カスタムキャッシュキーを作成していないことを確認してください。
概要
URL 署名機能は、パラメータフィルタリング機能よりも優先順位が高くなっています。署名タイプ A によって生成される署名情報には、HTTP リクエストのパラメータが含まれています。Alibaba Cloud CDN は、POP がリクエストされたリソースのコピーをキャッシュする前に、署名情報を確認します。URL 署名の構成方法の詳細については、「URL 署名の構成」をご参照ください。
パラメータの無視
説明
シナリオ
Alibaba Cloud CDN は、リクエスト URL 内の疑問符(
?
)以降のパラメータを削除するため、同じファイル宛てであるが異なる URL パラメータを持つリクエストがキャッシュにヒットするようになります。パラメータフィルタリングは、キャッシュヒット率を高め、オリジンフェッチ頻度を減らし、ファイル配信を高速化します。一部のユーザーは、リクエスト URL の疑問符(
?
)の後にパラメータを追加して、ユーザー ID(UID)、リクエストソース、レコメンデーションコードなどの情報をオリジンサーバーに渡します。この場合、これらの URL は、リクエストが同じファイル宛てであっても、異なるクエリ文字列を持ちます。URL 内の疑問符(
?
)以降のパラメータがリクエストされたリソースに関係ない場合は、パラメータフィルタリングを有効にすることをお勧めします。例:ユーザー A からのリクエスト:
http://example.com/1.jpg?uid=123***
ユーザー B からのリクエスト:
http://example.com/1.jpg?uid=654***
POP がユーザー A とユーザー B からの元の URL を使用する場合、リクエストはキャッシュ内の同じファイルにヒットできません。リクエストはオリジンサーバーにリダイレクトされる必要があります。
パラメータフィルタリングを有効にすると、POP はリクエスト URL 内の疑問符(
?
)以降の UID を削除します。最終的な URLhttp://example.com/1.jpg
がキャッシュの照合に使用されます。オリジンサーバーへのリクエストでパラメータを保持する
説明
シナリオ
主要なユーザー情報をオリジンサーバーに渡せるように、元の URL がオリジンサーバーにリダイレクトされます。
パラメータフィルタリングを有効にした場合、POP はパラメータフィルタリング機能によって処理された URL をオリジンサーバーにリダイレクトします。前の例では、ユーザー A とユーザー B からのリクエストは両方とも URL
http://example.com/1.jpg
を使用しています。UID は、オリジンフェッチ中にオリジンサーバーに渡されません。オリジンサーバーへのリクエストでパラメータを保持すると、POP は元の URL をオリジンサーバーにリダイレクトするため、UID がオリジンサーバーに渡されます。
パラメータフィルタリング機能では、指定したパラメータを保持または削除できます。次の図は、パラメータフィルタリングのプロセスを示しています。
手順
Alibaba Cloud CDN コンソールにログインします。
左側のナビゲーションウィンドウで、ドメイン名 をクリックします。
ドメイン名 ページで、管理するドメイン名を探し、管理 列の アクション をクリックします。
ドメイン名の左側のナビゲーションツリーで、パフォーマンスの最適化 をクリックします。
[パラメータの無視] セクションで、変更 をクリックします。表示されるダイアログボックスで、ビジネス要件に基づいてフィルターモードを選択し、パラメータを構成します。
重要別のフィルターモードに切り替えると、既存の構成はクリアされます。
フィルターモード: 指定したパラメータを保持する
パラメータ
説明
例
パラメーターを無視
はい: パラメータフィルタリング機能を有効にします。疑問符(
?
)以降のパラメータは URL から削除されます。説明パラメータの無視 パラメータを [はい] に設定し、指定したパラメータを保持する パラメータを指定しないと、疑問符(
?
)以降のすべてのパラメータが削除されます。いいえ: パラメータフィルタリング機能を無効にします。
元の URL が
http://example.com/1.jpg?key1=1&key2=2&key3=3
の場合、次の例は、異なる設定に基づいて 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 内のすべてのパラメータを保持します。
いいえ: オリジンフェッチ中にリクエスト URL 内の指定されたパラメータのみを保持します。パラメータはキャッシュキーと同じままです。
ルール条件
ルール条件は、リクエスト内のパラメータを識別して、構成がリクエストに適用されるかどうかを判断できます。
条件を使用しない
ルールエンジンで構成済みのルール条件を選択します。詳細については、「ルールエンジン」をご参照ください。
フィルターモード: 指定したパラメータを削除する
パラメータ
説明
例
指定したパラメータを削除する
削除するパラメータを最大 10 個まで指定できます。複数のパラメータはコンマ(,)で区切ります。
元の URL が
http://example.com/1.jpg?key1=1&key2=2&key3=3
の場合、次の例は、異なる設定に基づいて 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 内のすべてのパラメータを保持します。
いいえ: オリジンフェッチ中にリクエスト URL 内の指定されたパラメータのみを削除します。パラメータはキャッシュキーと同じままです。
ルール条件
ルール条件は、リクエスト内のパラメータを識別して、構成がリクエストに適用されるかどうかを判断できます。
条件を使用しない
ルールエンジンで構成済みのルール条件を選択します。詳細については、「ルールエンジン」をご参照ください。
OK をクリックします。