オリジン取得リクエスト URL のパラメーターを書き換える - CDN

元のリクエスト URL のパラメーターがオリジンサーバーで要求されるものと異なる場合、パラメーターの書き換え機能を使用して、オリジン取得リクエスト URL のパラメーターを書き換えることができます。この機能により、パラメーターの追加、削除、保持、変更、または無視が可能です。

URL パラメーターのフォーマット

URL パラメーターとは、URL の ? 文字の後に追加される、name=value フォーマットの 1 つ以上の name/value ペアです。複数のパラメーターは & で区切られます。
URL には # 文字とそれに続くテキストが含まれることもあります。# は、ブラウザにウェブページ上の特定の場所を指示します。

たとえば、http://www.example.com/index.html#segment の場合、#segment 部分は index.html ページ上の segment の場所を指します。ブラウザがページを読み込んだ後、自動的にその場所にスクロールします。

パラメーターの書き換え機能では、オリジン取得リクエスト URL のクエリパラメーターに対して複数の書き換え操作を設定できます。優先順位は、追加 > 削除 > 保持のみ > 変更です。異なる操作が同じパラメーターを対象とする場合、最も優先度の高い操作のみが有効になります。
パラメーターを無視 が有効になっている場合、有効になる他の操作は追加のみです。

back-to-origin パラメーターの書き換えは、「オリジンフェッチ URL の書き換え」の enhance break ルール、および「パラメーターの無視」機能と競合する可能性があります。競合が発生した場合、最後に設定された機能が優先されます。

back-to-origin パラメーターの書き換え 機能は、オリジン取得 POP で実行されます。CDN 内部ルーティングには影響せず、キャッシュキーも書き換えません。
パラメーターを無視機能は、エッジノードで実行されます。CDN 内部ルーティングに影響し、キャッシュキーを書き換えます。

重要

設定でルールエンジンのルール条件を使用する場合、その条件の優先度が実行順序を決定し、機能の設定順序を上書きします。

CDN コンソールにログインします。
左側のナビゲーションウィンドウで、ドメイン名 をクリックします。
ドメイン名 ページで、対象のドメイン名を見つけ、操作列の管理をクリックします。
ドメイン名の左側のナビゲーションウィンドウで、Back-to-Origin 設定 をクリックします。
back-to-origin パラメーターの書き換え タブをクリックします。
機能スイッチ をオンにします。
書き換えるパラメーターを設定します。

必要に応じて書き換え操作を設定します。各操作タイプのテキストボックスに複数のパラメーターを追加することもできます。詳細については、「設定例」をご参照ください。
OK をクリックして設定を適用します。

back-to-origin パラメーターの書き換え ページの変更をクリックして、既存のルールを変更することもできます。

例 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`