パラメーターフィルタリングを有効にすると、配信拠点(POP)は、リクエスト URL 内の疑問符(?
)以降のパラメーターを削除します。 これらのパラメーターには、ユーザー ID やリクエスト ソースなどの情報が含まれています。 元の URL はキャッシュキーとして使用されます。 このトピックでは、パラメーターフィルタリングを構成する方法について説明します。
カスタム CacheKey とパラメーターフィルタリング機能は、一緒に使用すると競合します。 パラメーターフィルタリングを有効にすると、配信拠点(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 をクリックします。