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

ApsaraVideo VOD:パラメータフィルタリング

最終更新日:Jan 28, 2026

パラメータフィルタリングを有効にすると、Alibaba Cloud CDN の POP (Point of Presence) はリクエスト URL 内のクエスチョンマーク (?) に続くパラメータを削除します。これらのパラメータには、ユーザー ID やアクセスチャネルなどの情報が含まれる場合があります。CDN は、この結果の URL を使用してキャッシュハッシュキーを生成します。このプロセスにより、キャッシュヒット率が向上し、コンテンツ配信が高速化されます。このトピックでは、パラメータフィルタリングの設定方法について説明します。

概要

説明

URL 署名機能は、パラメータフィルタリング機能よりも優先度が高くなります。署名タイプ A によって生成される署名情報には、HTTP リクエストのパラメータが含まれます。Alibaba Cloud CDN は、CDN の POP (Point of Presence) がリクエストされたリソースのコピーをキャッシュする前に、署名情報を検証します。URL 署名の設定方法の詳細については、「URL 署名の設定」をご参照ください。

  • パラメータの無視

    説明

    シナリオ

    Alibaba Cloud CDN は、リクエスト URL 内のクエスチョンマーク (?) に続くパラメータを削除し、異なる URL パラメータを持つ同じファイルへのリクエストがキャッシュにヒットするようにします。パラメータフィルタリングにより、キャッシュヒット率が向上し、オリジンフェッチの頻度が減り、ファイルの配信が高速化されます。

    一部のユーザーは、ユーザー ID (UID)、リクエストソース、推奨コードなどの情報をオリジンサーバーに渡すために、リクエスト URL のクエスチョンマーク (?) の後にパラメータを追加します。この場合、リクエストが同じファイルを対象としていても、これらの 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

次の表に、設定例とそれによって生成されるオリジン URL を示します。

パラメータ設定

キャッシュキー

オリジン URL

パラメータを無視:はい
指定したパラメータを保持しない
back-to-origin 時にパラメータを保持:いいえ

http://example.com/1.jpg

http://example.com/1.jpg

パラメータを無視:はい
指定したパラメータを保持:key1
back-to-origin 時にパラメータを保持:いいえ

http://example.com/1.jpg?key1=1

http://example.com/1.jpg?key1=1

パラメータを無視:はい
指定したパラメータを保持しない
back-to-origin 時にパラメータを保持:はい

http://example.com/1.jpg

http://example.com/1.jpg?key1=1&key2=2&key3=3

パラメータを無視:はい
指定したパラメータを保持:key1
back-to-origin 時にパラメータを保持:はい

http://example.com/1.jpg?key1=1

http://example.com/1.jpg?key1=1&key2=2&key3=3

指定したパラメータを削除:key1
back-to-origin 時にパラメータを保持:いいえ

http://example.com/1.jpg?key2=2&key3=3

http://example.com/1.jpg?key2=2&key3=3

指定したパラメータを削除:key1
back-to-origin 時にパラメータを保持:はい

http://example.com/1.jpg?key2=2&key3=3

http://example.com/1.jpg?key1=1&key2=2&key3=3

操作手順

  1. ApsaraVideo VOD コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[設定管理] > [CDN 設定] > [ドメイン名] を選択します。

  3. [ドメイン名] ページで、管理するドメイン名を見つけ、操作 列の [設定] をクリックします。

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

  5. [パラメータの無視] セクションで、変更 をクリックします。

  6. フィルタリングパターンやフィルタリングパラメータなど、必要な設定項目を構成します。

    次の表に各パラメータを説明します。

    重要

    フィルターパターンを切り替えると、現在の設定が削除されます。

    • フィルターパターン:指定したパラメータを保持

      パラメータ

      説明

      パラメーターを無視

      • [はい]:パラメータフィルタリングを有効にします。オリジンフェッチリクエストの場合、URL のクエスチョンマーク (?) に続くパラメータは削除されます。

        説明

        [パラメータを無視] をオンにしても [指定したパラメータを保持] を空のままにすると、クエスチョンマーク (?) に続くすべてのパラメータが削除されます。

      • [いいえ]:パラメータの無視機能を無効にします。

      元の URL が http://example.com/1.jpg?key1=1&key2=2&key3=3 であると仮定します。次の例は、さまざまな設定に基づいて CDN が 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 のすべてのパラメータを back-to-origin リクエストに保持します。

      • いいえ:back-to-origin リクエストのパラメータは、キャッシュハッシュキーのパラメータと同じになります。つまり、指定したパラメータのみが保持されます。

    • フィルターパターン:指定したパラメータを削除

      パラメータ

      説明

      指定したパラメータを削除

      削除するパラメータを指定します。最大 10 個のパラメータを指定できます。複数のパラメータはスペースで区切ります。

      元の URL が http://example.com/1.jpg?key1=1&key2=2&key3=3 であると仮定します。次の例は、さまざまな設定に基づいて CDN が 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 のすべてのパラメータを back-to-origin リクエストに保持します。

      • いいえ:back-to-origin リクエストのパラメータは、キャッシュハッシュキーのパラメータと同じになります。つまり、指定したパラメータは削除されます。

  7. 決定 をクリックします。