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

CDN:パラメーターを無視する

最終更新日:Oct 17, 2024

パラメーターのフィルタリングを有効にすると、ポイントオブプレゼンス (POP) はリクエストURLの疑問符 (?) に続くパラメーターを削除します。 これらのパラメーターには、ユーザーIDやリクエストソースなどの情報が含まれます。 元のURLがキャッシュキーとして使用されます。 このトピックでは、パラメーターのフィルタリングを設定する方法について説明します。

説明

カスタムCacheKeyとパラメーターのフィルター機能は、一緒に使用すると競合します。 パラメーターのフィルタリングを有効にすると、ポイントオブプレゼンス (POP) はリクエストURLの疑問符 (?) に続くパラメーターを削除します。 これにより、CacheKeyのリクエストパラメーターが無効になります。 したがって、パラメーターを変更する前に、カスタムキャッシュキーを作成していないことを確認してください。

概要

説明

URL署名機能は、パラメータフィルタリング機能よりも優先度が高い。 タイプAに署名することによって生成される署名情報は、HTTP要求内のパラメータを含む。 POPが要求されたリソースのコピーをキャッシュする前に、Alibaba Cloud CDNは署名情報を検証します。 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を削除します。 最終的なURL http://example.com/1.jpg は、キャッシュを一致させるために使用される。

  • back-to-originリクエストのパラメーターの保持

    説明

    シナリオ

    元のURLはオリジンサーバーにリダイレクトされ、重要なユーザー情報をオリジンサーバーに渡すことができます。

    パラメーターのフィルタリングを有効にすると、POPはパラメーターのフィルタリング機能によって処理されたURLをオリジンサーバーにリダイレクトします。 上記の例では、ユーザーAとユーザーBからのリクエストはどちらもURL http://example.com/1.jpg を使用しています。 UIDは、オリジンフェッチ中にオリジンサーバーに渡されません。

    back-to-originリクエストにパラメーターを保持している場合、POPは元のURLをオリジンサーバーにリダイレクトして、UIDがオリジンサーバーに渡されるようにします。

パラメータフィルタリング機能は、特定のパラメータを保持または除去することができる。 次の図は、パラメータフィルタリングのプロセスを示しています。

image

手順

  1. Alibaba Cloud CDNコンソール

  2. 左側のナビゲーションウィンドウで、ドメイン名.

  3. [ドメイン名] ページで、管理するドメイン名を見つけて、アクション 列の 管理 をクリックします。

  4. ドメイン名の左側のナビゲーションツリーで、パフォーマンスの最適化.

  5. [パラメーターを無視] セクションで、変更 をクリックします。 表示されるダイアログボックスで、ビジネス要件に基づいてフィルターモードを選択し、パラメーターを設定します。

    重要

    別のフィルタモードに切り替えると、既存の設定はクリアされます。

    • フィルタリングモード: 指定されたパラメータを保持

      パラメーター

      説明

      パラメーターを無視

      • Yes: パラメーターフィルター機能を有効にします。 疑問符 (?) に続くパラメータはURLから削除されます。

        説明

        [パラメーターを無視] パラメーターを [はい] に設定し、[指定したパラメーターを保持] パラメーターを指定しないと、疑問符 (?) に続くすべてのパラメーターが削除されます。

      • No: パラメーターフィルター機能を無効にします。

      元の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個まで指定できます。 複数のパラメーターはコンマ (,) で区切ります。

      オリジンパラメーターの保持

      • Yes: オリジンフェッチ中にリクエストURLのすべてのパラメーターを保持します。

      • No: オリジンフェッチ中にリクエスト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

      オリジンパラメーターの保持

      • Yes: オリジンフェッチ中にリクエストURLのすべてのパラメーターを保持します。

      • いいえ: オリジンフェッチ中にリクエストURLの指定されたパラメーターのみを削除します。 パラメーターはキャッシュキーのパラメーターと同じままです。

      ルール条件

      ルール条件は、構成が要求に適用されるかどうかを決定するために要求内のパラメータを識別できる。

      • 条件を使用しない

      • ルールエンジンで設定されたルール条件を選択します。 詳細については、「ルールエンジン」をご参照ください。

  6. OK.