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

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

最終更新日:Jul 12, 2025

パラメーターフィルタリングを有効にすると、配信拠点(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 を削除します。 最終的な 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 をクリックします。