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

CDN:パラメータの無視

最終更新日:Apr 14, 2025

パラメータフィルタリングを有効にすると、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 を削除します。最終的な URL http://example.com/1.jpg がキャッシュの照合に使用されます。

  • オリジンサーバーへのリクエストでパラメータを保持する

    説明

    シナリオ

    主要なユーザー情報をオリジンサーバーに渡せるように、元の URL がオリジンサーバーにリダイレクトされます。

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

    オリジンサーバーへのリクエストでパラメータを保持すると、POP は元の URL をオリジンサーバーにリダイレクトするため、UID がオリジンサーバーに渡されます。

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

image

手順

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

  2. 左側のナビゲーションウィンドウで、ドメイン名 をクリックします。

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

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

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

    重要

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

    • フィルターモード: 指定したパラメータを保持する

      パラメータ

      説明

      パラメーターを無視

      • はい: パラメータフィルタリング機能を有効にします。疑問符(?)以降のパラメータは 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 内の指定されたパラメータのみを削除します。パラメータはキャッシュキーと同じままです。

      ルール条件

      ルール条件は、リクエスト内のパラメータを識別して、構成がリクエストに適用されるかどうかを判断できます。

      • 条件を使用しない

      • ルールエンジンで構成済みのルール条件を選択します。詳細については、「ルールエンジン」をご参照ください。

  6. OK をクリックします。