ユーザーのリクエスト URL に含まれるパラメーターがオリジンサーバーの要件と異なる場合、パラメーター書き換え機能を使用して、オリジンリクエストのクエリパラメーターを変更できます。この機能により、特定のパラメーターを追加、削除、変更、または保持することができ、またすべてのパラメーターを無視することも可能です。
背景情報
パラメーター書き換え機能は、オリジンリクエスト URL のクエリパラメーターを変更します。複数の書き換えルールを設定できます。ルールは以下の優先度順に適用されます：追加 > 削除 > パラメーターを無視 および 保持のみ > 変更。複数のルールが同一パラメーターを対象とする場合、最も優先度の高いルールのみが適用されます。
パラメーターを無視 と 保持のみ は相互排他です。両方を同時に設定しないでください。
競合
[パラメーター書き換え] 機能は、URI 書き換え 機能の enhance break ルールおよび パラメータフィルタリング 機能と競合する可能性があります。競合する構成を作成しないでください。競合が発生した場合、最後に構成された機能が優先されます。
DCDN は、オリジン POP で パラメーター書き換え ルールを処理します。これにより、内部リクエストフローおよびキャッシュキーには影響しません。
DCDN は、エッジ POP で パラメータフィルタリング ルールを処理します。これにより、内部リクエストフローに影響し、キャッシュキーが変更されます。
操作手順
-
DCDN コンソール にログインします。
-
左側のナビゲーションウィンドウで ドメイン名 をクリックします。
-
[ドメイン名]ページで、管理するドメイン名を見つけ、[アクション]列の[設定]をクリックします。
ドメインの左側ナビゲーションウィンドウで [オリジンフェッチ] をクリックします。
[パラメーター書き換え] タブをクリックします。
[パラメーター書き換え] タブで [パラメーター書き換えを使用] を有効にします。
書き換えルールを設定します。
ビジネス要件に基づいてルールを設定してください。詳細については、「構成例」をご参照ください。
設定を適用するには [OK] をクリックします。
[パラメーター書き換え] ページで、[設定の変更] をクリックして、既存のルールを変更することもできます。
注記：この機能を ルールエンジン 内のアクションとして使用する場合、ルールエンジン で設定されたルールの優先度が、この機能の内部処理優先度をオーバーライドします。
構成例
例 1：すべてのパラメーターを無視する
パラメーター
例
パラメーターを無視
有効
追加
なし
削除
なし
予約のみ
なし
変更
なし
期待される結果
元のリクエスト：
http://example.com/index.html?code1=1&code2=2&code3=3書き換え後のオリジンリクエスト：
http://example.com/index.html例 2：特定のパラメーターのみを保持する
パラメーター
例
パラメーターを無視
なし
追加
なし
削除
なし
予約のみ
code2
変更
なし
期待される結果
元のリクエスト：
http://example.com/index.html?code1=1&code2=2&code3=3書き換え後のオリジンリクエスト：
http://example.com/index.html?code2=2例 3：パラメーターの追加、削除、変更を同時に行う
パラメーター
例
パラメーターを無視
なし
追加
code4=4
削除
code2
予約専用
なし
変更
code3=0
期待される結果
元のリクエスト：
http://example.com/index.html?code1=1&code2=2&code3=3書き換え後のオリジンリクエスト：
http://example.com/index.html?code1=1&code3=0&code4=4