Server Load Balancer:ドメイン名とURL パスのマッチング用転送ルール

設定例

転送ルールにおけるドメインマッチング

ALB は、転送ルールを優先度番号の小さい順に評価し、最初に一致したルールで停止します。ルールは、ドメインの具体性によって自動的にソートされません。この動作は、具体性に基づいてルールを自動的に優先する CLB とは異なります (例: 完全一致 > より限定的なワイルドカード > より広範なワイルドカード)。

たとえば、リスナーに次の 2 つのルールがあるとします。

www.example.com へのリクエストは、ルール 1 の優先度番号が低いため、ルール 2 (完全一致ルール) ではなく、ルール 1 (ワイルドカードルール) に一致します。

ベストプラクティス：より具体的なルールが先に評価されるように、そのルールには、より一般的 (具体的でない) なルールよりも低い優先度番号を割り当ててください。たとえば、www.example.com のルールを優先度 1 に、*.example.com のルールを優先度 2 に設定してください。

転送ルールのパスマッチング

書き換えとリダイレクトのための高度なパス設定

• 注意事項

  • 転送条件の正規表現で、丸かっこ( )によって定義されるキャプチャグループの数は、転送アクションの書き換えパスまたはリダイレクトパスにある ${n} 変数の数と一致する必要があります。

  • 転送アクションの書き換えまたはリダイレクトのパスには、${1}、${2}、${3} を 1 つ以上含める必要があります。これらの変数を他の文字に置き換えないでください。

  • 書き換えまたはリダイレクトのパスでは、$ 文字は、次の変数を参照する場合にのみ使用してください：${host}、${path}、${port}、${protocol}、${query}、および ${1}、${2}、${3} などの正規表現キャプチャグループ変数です。その他の変数はサポートされていません。

• 仕組み

  1. パス照合：クライアントが、転送ルール内の正規表現に一致するリクエストを送信します。

  2. 抽出と置換: システムは、丸括弧 ( ) で定義された最初の 3 つのキャプチャグループからコンテンツを抽出し、${1}、${2}、および ${3} 変数に保存します。 これらの変数は、転送アクションの書き換えまたはリダイレクトパスでの置換に使用されます。

  3. パスの生成：システムは ${1}、${2}、${3} 変数をキャプチャした値に置き換え、書き換えまたはリダイレクトの最終パスを生成します。

  番号	手順	例
  1	転送ルールの転送条件と転送アクションを設定します。	転送条件のパス：/app/(.*)/(.*)/settings 書き換えまたはリダイレクトアクションのパス：/${1}/${2}
  2	クライアントが、パスに一致するリクエストを送信します。	クライアントからのリクエストパス：/app/users/profile/settings 転送条件で一致したパス：/app/(.*)/(.*)/settings
  3	値を抽出して置換します。	システムは、転送条件のパスに含まれる 2 つの (.*) キャプチャグループから users と profile を抽出し、転送アクション用の ${1} および ${2} 変数にそれぞれ保存します。 ${1} は users に置換されます。 ${2} は profile に置換されます。
  4	パスを生成します。	バックエンドサーバーが受信するパス：/users/profile

• 設定例

  コンソールで転送ルールを追加する際は、前述の注意事項と仕組みを参照してください。

  例 1：[転送操作]を[書き換え]および[転送]に設定

  この例では、パス /app/users/profile/settings を /users/profile に書き換えた後、リクエストをバックエンドサーバーに転送する方法を示します。正規表現 /app/(.*)/(.*)/settings は 2 つのキャプチャグループを使用して users と profile を抽出します。書き換え後のパスでは、/${1}/${2} を使用して最終パスを生成します。

  パラメーター		説明
  転送条件	パス	正規表現 | 大文字と小文字を区別しない を選択し、正規表現 /app/(.*)/(.*)/settings を入力します。 たとえば、クライアントがパス /app/users/profile/settings をリクエストした場合、ルールは一致します。キャプチャグループは users と profile を抽出し、それぞれ ${1} と ${2} 変数に保存されます。
  [転送操作]	[書き換え]	[ドメイン名]：${host} [パス]：/${1}/${2} [クエリ]：${query} [クエリ]は、URL のクエスチョンマーク (?) の後に続く部分です。たとえば、URL www.example.com/test/test1?x=1 の場合、[クエリ]は x=1 です。
  	[転送]	サーバーグループのリストから転送先のサーバーグループを選択します。

  例 2：転送アクションを「リダイレクト」に設定

  次の例では、パス /app/users/profile/settings を /users/profile にリダイレクトします。例 1 と異なり、このリダイレクトは 301 ステータスコードを返し、ブラウザーのアドレスバーに表示される URL が変わります。

  パラメーター		説明
  転送条件	パス	正規表現 | 大文字と小文字を区別しない を選択し、正規表現 /app/(.*)/(.*)/settings を入力します。 たとえば、クライアントがパス /app/users/profile/settings をリクエストした場合、ルールは一致します。キャプチャグループは users と profile を抽出し、それぞれ ${1} と ${2} 変数に保存されます。
  [転送操作]	[リダイレクト]	[プロトコル]：${protocol} [ドメイン名]：${host} [ポート]：${port} [パス]：/${1}/${2} [クエリ]：${query} [ステータスコード]：301

よくある質問

関連ドキュメント

ALB のリスナー転送ルールの設定手順については、「リスナー転送ルールの設定」をご参照ください。