list_b バルクリダイレクトリスト
| ソースURL | ターゲットURL | ステータスコード |
|---|---|---|
example.com/about | https://example.com/news | 301 (デフォルト) |
example.com/new_feature | https://example.com/soon | 302 |
概念
バルクリダイレクトには、以下の要素が含まれます：
-
URLリダイレクト: ソースURL、ターゲットURL、ステータスコード、およびリダイレクトパラメータを持つシンプルなオブジェクト。URLリダイレクトは、バルクリダイレクトリストのリスト項目です。
-
バルクリダイレクトリスト: 1つ以上のURLリダイレクトを含む、IPリストに似たリスト。バルクリダイレクトリスト内のすべてのURLリダイレクトを有効にするには、バルクリダイレクトルールでリストを参照します。異なるバルクリダイレクトルールが同じバルクリダイレクトリストを参照することができます。
-
バルクリダイレクトルール: ルールセットエンジンによって駆動されるルールで、変換ルールに似ています。バルクリダイレクトルールには、関連するバルクリダイレクトリストがあります。
バルクリダイレクトルールは、1つ以上のURLリダイレクトを含むバルクリダイレクトリストを有効にします。
以下の例では、2つのURLリダイレクトを持つlist_bという名前のバルクリダイレクトリストを定義します：
以下のバルクリダイレクトルール、Rule 2は、list_bバルクリダイレクトリスト内のURLリダイレクトを有効にします：
Rule 2 バルクリダイレクトルール
- ルール名:
Rule 2 - 関連リスト:
list_b
URLリダイレクトを使用すると、ソースURL、ターゲットURL、ステータスコード、およびリダイレクトパラメータを設定できます。
ソースURLを指定する際は、サポートされていないワイルドカードの代わりに、利用可能なリダイレクトパラメータを使用してください。たとえば、サブドメインを含めるパラメータを使用すると、サブドメイン（例：https://b.example.comおよびhttps://a.b.example.com）とアペックスドメイン（https://example.com）の両方に適用される単一のURLリダイレクトを設定できます。他のパラメータを使用すると、ソースURLのパスとクエリ文字列の処理方法を指定できます。詳細については、動作の仕組みを参照してください。
URLリダイレクトは、バルクリダイレクトリストのリスト項目です。
バルクリダイレクトリストを使用すると、異なる目的のためにURLリダイレクトの明確なグループを作成できます。バルクリダイレクトリストは、1つ以上のバルクリダイレクトルールで使用できます。
バルクリダイレクトリストは単独でリダイレクトを実行しません — リスト内のリダイレクトを有効にするには、バルクリダイレクトルールでリストを参照する必要があります。
バルクリダイレクトリストには、正確に同じソースURLを持つ複数のURLリダイレクトを含めることはできません。
バルクリダイレクトリストにアイテムをインポートするためのCSV形式の詳細については、CSVファイル形式を参照してください。
バルクリダイレクトルールは、バルクリダイレクトリストを介して1つ以上のURLリダイレクトを有効にする、ルールセットエンジンによって駆動されるルールです。
バルクリダイレクトルールを設定すると、バルクリダイレクトリストを関連付けることで、そのリスト内のすべてのURLリダイレクトを有効にします。各リストに対してルールを作成することも、同じバルクリダイレクトリストを参照する多くのバルクリダイレクトルールを持つこともできます。
バルクリダイレクトルールは、ルールセットエンジンによって駆動されるすべてのルールと同様に、アクションと式を持っています。これら2つのプロパティに加えて、名前、オプションの説明、関連するバルクリダイレクトリスト、およびキーも持っています。
ルール式、またはフィルター式は、ルールが実行されるために満たすべき条件を指定します。デフォルトでは、指定されたリストのすべてのURLリダイレクトが適用されます。
バルクリダイレクトルールのデフォルト式は次のとおりです：
http.request.full_uri in $<LIST_NAME>この式は、リクエストURLが、基本的な正規化（URL正規化が有効な場合）を経た後、リダイレクトが適用されるためにリスト<LIST_NAME>内のURLリダイレクトのソースURLと一致する必要があることを意味します。
URLリダイレクトの一致の特異性を高めるために、デフォルトの式とは異なる式を使用できます。たとえば、バルクリダイレクトルールの式を次の式に設定すると、イギリスからのリクエストにのみ一致します：
ip.src.country == "GB" and http.request.full_uri in $<LIST_NAME>利用可能なフィールドの詳細については、利用可能なフィールドと関数を参照してください。
ルールキーは、ルールに関連付けられたバルクリダイレクトリストと組み合わせて使用され、適用するURLリダイレクトを選択します。
ルール式に一致する場合、Cloudflareはルールキーの値を関連付けられたバルクリダイレクトリスト内の各URLリダイレクトのソースURLと比較し、一致を探します。
キーはhttp.request.full_uriまたはraw.http.request.full_uriのいずれかである必要があります。raw.http.request.full_uriを使用して、正規化前にWebサーバーによって受信されたURIをバルクリダイレクトリスト内のソースURLと比較します。
キーで使用されるURIフィールドは、式で使用されるURIフィールドと同じでなければなりません。そうでない場合、ルール式に一致しても、リスト内のソースURLのいずれかに一致しない可能性があります。たとえば、キーをhttp.request.full_uriに設定した場合、ルール式で使用されるフィールドもhttp.request.full_uriである必要があります。逆に、キーをraw.http.request.full_uriに設定した場合、式で使用されるフィールドもraw.http.request.full_uriでなければなりません。