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

ApsaraVideo VOD:Parameter filtering

最終更新日:Oct 23, 2024

パラメータフィルタリング機能を有効にすると、Alibaba Cloud CDNはリクエストURLでの疑問符?に続くパラメータを削除します。パラメータには、ユーザーIDやリクエストソースなどの情報が含まれます。 元のURLは、キャッシュキーを生成するために使用されます。 これにより、キャッシュヒット率が向上し、コンテンツ配信が高速化します。 このトピックでは、パラメーターのフィルタリングを設定する方法について説明します。

概要

説明

URL署名機能は、パラメータフィルタリング機能よりも優先度が高い。 タイプAに署名することによって生成される署名情報は、HTTP要求内のパラメータを含みます。 Alibaba Cloud CDNは、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 は、キャッシュを一致させるために使用されます。

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

    説明

    シナリオ

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

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

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

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

image

手順

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

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

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

  4. 表示されるページで、[パフォーマンスの最適化] をクリックします。

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

  6. [パラメーターフィルター] ダイアログボックスで、ビジネス要件に基づいてパラメーターを設定します。

    下表に、各パラメーターを説明します。

    重要

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

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

      パラメーター

      説明

      パラメーターを無視

      • 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の指定されたパラメーターのみを削除します。 パラメーターはキャッシュキーのパラメーターと同じままです。

      ルール条件

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

      • 条件を使用しない

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

  7. [OK] をクリックします。