ドメイン名ベースおよびパスベースの転送ルールの設定方法 - Global Accelerator

転送条件におけるドメイン名の設定

ドメイン名ベースの転送ルールでは、特定のドメイン名、ワイルドカードドメイン名、または正規表現を転送条件として指定できます。転送ルールの追加方法の詳細については、「転送ルールの追加」をご参照ください。

一致タイプ	説明
完全一致	一致条件完全一致：リクエストされたドメイン名は、指定されたドメイン名と同じである必要があります。ワイルドカード一致：リクエストされたドメイン名は、指定されたドメイン名のワイルドカードパターンと一致する必要があります。要件ドメイン名は 3～128 文字で、文字、数字、`ハイフン (-)、ピリオド (.)` のみを含めることができます。ワイルドカード文字としてアスタリスク (``) と疑問符 (`?`) を使用できます。例リクエストされたドメイン名：www.example.com 完全一致：転送ルールで `www.example.com` が指定されている場合にのみ一致します。ワイルドカード一致：転送ルールで `.example.com` または `www.example.*` が指定されている場合に一致します。
正規表現一致 (大文字と小文字を区別しない)	一致条件リクエストされたドメイン名は、指定された正規表現と一致する必要があります。要件ドメイン名は 3～128 文字で、文字、数字、および次の特殊文字のみを含めることができます： `. - ? = ~ _ + / \ ^ * ! $ & \| ( ) [ ]` 例リクエストされたドメイン名：www.Example.com 転送ルールで `^www.example.com$` が指定されている場合に一致します。

転送条件におけるパスの設定

パスベースの転送ルールでは、特定のパス、ワイルドカードパス、または正規表現を一致条件として指定できます。転送ルールの追加方法の詳細については、「転送ルールの追加」をご参照ください。

一致タイプ	説明
完全一致	一致条件完全一致：リクエストされたパスは、指定されたパスと同じである必要があります。ワイルドカード一致：リクエストされたパスは、指定されたパスのワイルドカードパターンと一致する必要があります。要件パスは 1～128 文字で、スラッシュ (`/`) で始まる必要があります。パスには、文字、数字、および次の特殊文字のみを含めることができます： `$ - _ . + / & ~ @ : '`。ワイルドカード文字としてアスタリスク (``) と疑問符 (`?`) を使用できます。例リクエストされたパス：/example/text 完全一致：転送ルールで `/example/text` が指定されている場合にのみ一致します。ワイルドカード一致：転送ルールで `/example/` が指定されている場合に一致します。説明 Global Accelerator のパス一致ルールは NGINX のルールとは異なります。Global Accelerator は最長プレフィックス一致ルールをサポートしていません。たとえば、NGINX で設定される一般的なパスは `location /abc` です。パスを一致させるために最長プレフィックス一致ルールが使用されます。最長プレフィックス一致を実行するために、Global Accelerator はワイルドカード文字を使用します。Global Accelerator で `/abc/*` を設定して、最長プレフィックス一致を実行できます。
正規表現一致 (大文字と小文字を区別する)	一致条件リクエストされたパスは、指定された正規表現と一致します。要件正規表現には、文字、数字、および次の特殊文字を含めることができます： `. - _ / \ = ? ~ ^ * $ : ( ) [ ] + \| " ' @` 例リクエストされたパス： `/sys/aaa/HOST` 転送ルールで `^/sys/(.*)/HOST$` が指定されている場合に一致します。

書き換えとリダイレクト用のパス設定

書き換えまたはリダイレクトのルールで正規表現を一致条件として指定すると、その正規表現はリクエストがリダイレクトまたは書き換えられる先のパスによって上書きされます。転送ルールの追加方法の詳細については、「転送ルールの追加」をご参照ください。

説明

パスベースの転送条件で正規表現を設定する方法の詳細については、本トピックの「転送条件におけるパスの設定」セクションをご参照ください。

注意事項
- 丸括弧 (( )) で定義されるキャプチャグループの数は、書き換え先またはリダイレクト先のパス内にある、ドル記号 ($) で定義される変数の数と同じである必要があります。
- 最大 3 つの変数 (${1}、${2}、${3}) を使用して、元のパスを上書きするパスを作成できます。変数を他の文字に置き換えることはできません。

操作手順

パス一致：クライアントがリクエストを送信し、パスベースの転送ルールの正規表現に一致します。
抽出と置換：丸括弧 (( )) で定義されるキャプチャグループから抽出されたコンテンツは、${1}、${2}、${3} に書き込まれます。このコンテンツは、書き換え先またはリダイレクト先のパスで使用されます。
連結：変数 ${1}、${2}、${3} は実際の値に置き換えられます。これらの値が連結されて、実際のパスが作成されます。

番号	ステップ	例
1	転送ルールで転送条件と転送アクションを設定します。	転送条件のパス： `/sys/(.)/(.)/aaa` 書き換え先またはリダイレクト先のパス： `/${1}/${2}`
2	クライアントリクエストが転送ルールのパスと一致します。	リクエストされたパス： `/sys/ccc/bbb/aaa` 一致したパス： `/sys/(.)/(.)/aaa`
3	システムは正規表現から値を抽出し、変数をその値に置き換えます。	`ccc` と `bbb` は正規表現の `(.*)` から抽出され、書き換え先またはリダイレクト先のパス内の変数 `${1}` と `${2}` を置き換えます。 `${1}` は `ccc` に置き換えられます。 `${2}` は `bbb` に置き換えられます。
4	値が連結されて、実際のパスが作成されます。	バックエンドサーバーが受信するパスは `/ccc/bbb` です。

例

上記の注意事項と手順に基づいて、GA コンソールで転送ルールを作成できます。次の例は、転送ルールの設定方法を示しています。

例 1：アクションが「書き換え」と「転送」のルールの設定

パラメーター		説明
[転送条件]	[パス]が[正規表現一致 (大文字と小文字を区別する)]	一致条件リクエストされたパスは、指定された正規表現と一致します。要件正規表現には、文字、数字、および次の特殊文字を含めることができます： `. - _ / \ = ? ~ ^ * $ : ( ) [ ] + \| " ' @` 例リクエストされたパス： `/sys/ccc/bbb/aaa` 転送条件として `/sys/(.)/(.)/aaa` が指定されている場合、リクエストされたパスは一致します。
[アクション]	[リライト]	[ドメイン名]：書き換え先のドメイン名を指定します。このパラメーターを空にした場合、元のドメイン名が保持されます。 [パス]：書き換え先のパスを指定します。このパラメーターを空にした場合、元のパスが保持されます。パスの拡張機能の詳細については、「書き換えとリダイレクト用のパス設定」セクションをご参照ください。 [検索]：書き換え先のクエリ文字列を指定します。このパラメーターを空にした場合、元のクエリ文字列が保持されます。
[アクション]	[転送]	ドロップダウンリストから仮想エンドポイントグループを選択します。

例 2：アクションが「リダイレクト」の転送ルールの設定

パラメーター		説明
[転送条件]	[パス]が[正規表現一致 (大文字と小文字を区別する)]	一致条件リクエストされたパスは、指定された正規表現と一致します。要件正規表現には、文字、数字、および次の特殊文字を含めることができます： `. - _ / \ = ? ~ ^ * $ : ( ) [ ] + \| " ' @` 例リクエストされたパス： `/sys/ccc/bbb/aaa` 転送条件として `/sys/(.)/(.)/aaa` が指定されている場合、リクエストされたパスは一致します。
[アクション]	[リダイレクト]	[プロトコル]：リダイレクトのプロトコルを指定します。有効な値：HTTP および HTTPS。このパラメーターを空にした場合、デフォルト値の HTTP が使用されます。 [ドメイン名]：リダイレクトのドメイン名を指定します。このパラメーターを空にした場合、元のドメイン名が保持されます。 [ポート]：リダイレクトのポートを指定します。このパラメーターを空にした場合、デフォルト値は HTTP リスナーの場合は 80、HTTPS リスナーの場合は 443 になります。 [パス]：リダイレクトのパスを指定します。このパラメーターを空にした場合、元のパスが保持されます。パスの拡張機能の詳細については、「書き換えとリダイレクト用のパス設定」セクションをご参照ください。 [検索]：リダイレクトのクエリ文字列を指定します。このパラメーターを空にした場合、元のクエリ文字列が保持されます。 [ステータスコード]： `301`