Server Load Balancer:リスナーの転送ルール

[ルール名]

任意。このパラメーターを空のままにすると、システムが自動的に名前を生成します。

[転送条件]

条件タイプを選択して、次の条件を 1 つ以上追加します。また、条件の追加 をクリックして、複数の条件を追加することもできます。

• [ドメイン名]：1 つ以上のドメイン名を追加します。ドメイン名は 3～256 文字の長さで、アスタリスク (*) や疑問符 (?) などのワイルドカード文字を含めることができます。アスタリスク (*) は任意の文字列に一致し、疑問符 (?) は 1 文字に一致します。サポートされている一致タイプには、完全一致、ワイルドカード一致、正規表現一致があります。ドメイン名の設定ルールの詳細については、「転送ルールの設定例とドメイン名およびパスの一致ルール」をご参照ください。

  • 完全一致：リクエストのドメイン名は、指定されたドメイン名と完全に一致する必要があります。例：www.example.com。

  • ワイルドカード一致：アスタリスク (*) はドット (.) を含む任意の文字列に、疑問符 (?) は単一の文字に一致します。例：*.example.com は api.example.com と www.example.com に一致します。

  • 正規表現一致：ドメイン名の一致に正規表現を使用します。一致では大文字と小文字は区別されません。例：^www\.example\.(com|cn)$ は、.com または .cn で終わるドメイン名に一致します。

• [パス]：1 つ以上のパスを追加します。正規表現パスと非正規表現パスの両方がサポートされています。パス設定ルールの詳細については、「転送ルールの設定例とドメイン名およびパスの一致ルール」をご参照ください。

  • 完全一致：例：/api/v1/users は、そのパスにのみ完全に一致します。

  • ワイルドカード一致：例：/api/* は、サブパスを含む /api/ で始まるすべてのパスに一致します。/* はすべてのパスに一致します。パスの一致では大文字と小文字が区別されます。

  • 正規表現一致：例：^/api/(.*)/list$ は、/api/ で始まり /list で終わるパスに一致します。正規表現パスの一致で大文字と小文字を区別するかどうかを選択できます。

• [HTTP ヘッダー]：キー フィールドに HTTP ヘッダー名を入力し、値 フィールドにその値を入力します。複数のヘッダー値を追加できます。ヘッダーキーは 1～40 文字の長さで、英字、数字、アンダースコア (_)、ハイフン (-) のみを含めることができます。一致では大文字と小文字は区別されません。ヘッダー値は 1～128 文字の長さで、印刷可能な文字を含めることができます。値の先頭または末尾にスペースは使用できません。アスタリスク (*) や疑問符 (?) などのワイルドカード文字を使用できます。

  例：キーが user-agent、値が *Mozilla/4.0* の場合、この設定は値に Mozilla/4.0 が含まれるすべてのリクエストに一致します。

• [クエリ文字列]：クエリ文字列のキーと値のペアを 1 つ以上追加します。キーの長さは 1～100 文字、値の長さは 1～128 文字です。小文字 (入力は小文字のみ受け付けられますが、一致では大文字と小文字は区別されません)、アスタリスク (*)、疑問符 (?) などの表示可能な文字を使用できます。スペースや、#[]{}\|<>& などの特殊文字はサポートされていません。

  例：URL が www.example.com/test/test1?x=1&y=2 の場合、条件を x:1 または y:2 として設定できます。

• [HTTP リクエストメソッド]：1 つ以上の HTTP リクエストメソッドを追加します。有効な値は HEAD、GET、POST、OPTIONS、PUT、PATCH、DELETE です。

• クッキー：1 つ以上のクッキーを追加します。キーの長さは 1～100 文字、値の長さは 1～128 文字です。小文字 (入力は小文字のみ受け付けられますが、一致では大文字と小文字は区別されません)、アスタリスク (*)、疑問符 (?) などの表示可能な文字を使用できます。スペースや、[]{}<>\#|& などの特殊文字はサポートされていません。

  例：キーが key、値が value。

• ソース IP：1 つ以上の IP アドレスまたは CIDR ブロックを追加します。0.0.0.0/x (x は数字です) の形式の CIDR ブロックはサポートされていません。

  例：192.168.1.1/32

[転送操作]

アクションタイプを選択して、次のアクションを 1 つ以上追加します。また、操作の追加 をクリックして、複数のアクションを追加することもできます。

• [転送]：リストからターゲットサーバーグループを選択します。サポートされているサーバーグループタイプは、サーバー、IP、Function Compute です。複数のサーバーグループを追加し、各サーバーグループに 重み を設定して、トラフィックの分散比率を制御できます。デフォルトでは、単一のサーバーグループの重みの範囲は 0～100 です。複数のサーバーグループを追加する場合は、サーバーグループのセッション永続性 を有効にできます。この機能を使用するには、追加したすべてのサーバーグループでセッション維持を有効にする必要があります。

  複数のサーバーグループを追加する場合、HTTP や HTTPS など、異なるバックエンドプロトコルを使用するサーバーグループを選択できます。

  単一のサーバーグループの最大重みは 10,000 まで増やすことができます。この引き上げをリクエストするには、アカウントマネージャーにお問い合わせください。

• [リダイレクト]：プロトコル と ステータスコード のドロップダウンリストから、プロトコルとステータスコードを選択します。次に、宛先の ドメイン名、ポート、パス、クエリ を指定します。プロトコル、ドメイン名、ポート、パス、または クエリ のいずれかのパラメーターに、デフォルト以外の値を指定する必要があります。

  リダイレクト アクションの パス パラメーターの高度な設定ルールについては、「書き換えとリダイレクトの高度なパス設定」をご参照ください。

  ${host}、${path}、${port}、${protocol}、${query} などのフィールドのデフォルト値は、リクエスト内の対応する値を参照します。パスフィールドでは、${host}、${path}、${port}、${protocol}、および ${1}、${2}、${3} などの正規表現キャプチャグループ変数への参照のみ使用できます。その他の $ 変数は使用できません。

  ステータスコードの詳細については、「標準 HTTP ステータスコード」をご参照ください。

• [固定レスポンスを返す]：レスポンスステータスコード を入力します。応答コンテンツタイプ (オプション) と 応答コンテンツ (オプション) を指定することもできます。レスポンスステータスコードは、2xx、4xx、または 5xx 形式の数字の文字列である必要があります。ここで x は数字を表します。

• [書き換え]：リクエストがバックエンドサーバーに転送される前に、リクエストの ドメイン名、パス、または クエリ を指定された値に変更します。クライアントのブラウザのアドレスバーの URL は変更されません。

  書き換え アクションは、転送 アクションと併用した場合にのみ有効になります。

  書き換え と リダイレクト の違い：書き換えは、バックエンドサーバーが受け取るパスを変更する内部的な ALB 操作です。クライアントの URL は変更されません。リダイレクトは 3xx ステータスコードを返し、クライアントのブラウザを新しい URL へ遷移させます。

  例： /app/page を /v2/page に書き換えるには、完全一致方式を使用してパス条件を /app/page に設定し、書き換えパスを /v2/page に設定します。 /app/ 配下のすべてのサブパスを照合して書き換えるには、正規表現を使用します。詳細については、「書き換えとリダイレクトのための高度なパス設定」をご参照ください。

  書き換えパスでは、$ 文字は、${host}、${path}、${port}、${protocol}、および ${1}、${2}、${3} などの正規表現キャプチャグループ変数の参照にのみ使用できます。その他の変数は使用できません。

• [ヘッダーの追加]：ヘッダー名と値を入力します。このアクションは、同じ名前の既存のリクエストヘッダーを上書きします。ヘッダーキーは 1～40 文字の長さで、英字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。ヘッダー値は 1～128 文字の長さで、英字、数字、および一般的な句読点を含めることができます。値の先頭または末尾にスペースは使用できません。

• [ヘッダーの削除]：ヘッダー名を入力して、リクエストヘッダーから対応するキーと値のペアを削除します。

  インバウンドの ヘッダーの追加 および ヘッダーの削除 アクションを使用する場合、以下のヘッダー名は指定できません。一致では大文字と小文字は区別されません。これらのヘッダーは ALB によって予約されているか、HTTP プロトコルにおいて重要です。これらを変更すると、リクエストの転送エラーや接続の中断が発生する可能性があります。slb-id、slb-ip、x-forwarded-for、x-forwarded-proto、x-forwarded-eip、x-forwarded-port、x-forwarded-client-srcport、x-forwarded-host、connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority。

• [トラフィック調整]：ビジネス要件に基づいて、次のパラメーターを設定します。

  • [QPS (合計)]：1 秒あたりのクエリ数を指定します。有効な値：1～1,000,000。

  • [QPS (クライアント IP あたり)]：各ソース IP アドレスの QPS 制限を指定します。有効な値：1～1,000,000。QPS (合計) と QPS (クライアント IP あたり) の両方を設定する場合、QPS (クライアント IP ごと) の値は QPS (合計) の値より小さくする必要があります。

  トラフィック調整 アクションは、転送 アクションと併用する必要があります。QPS 制限内のリクエストは、ターゲットサーバーグループに転送されます。デフォルトでは、ALB は QPS 制限を超えたリクエストに対して 503 ステータスコードを返します。または、リダイレクト または 固定レスポンスを返す アクションを追加して、これらのリクエストを処理することもできます。

  QPS (クライアント IP あたり) を有効にすると、ALB は X-Forwarded-For ヘッダーから送信元 IP アドレスを取得します。リクエストが複数のプロキシを経由する場合は、リスナーの 実際のクライアントソース IP を見つける を有効にして、ALB が正しいクライアントの送信元 IP アドレスを取得できるようにします。詳細については、「リスナーの作成と管理」をご参照ください。

• [トラフィックミラーリング]：リストからターゲットサーバーグループを選択します。[サーバー] または [IP] サーバーグループを選択できます。

• [CORS]：クロスオリジンリソース共有 (CORS) ポリシーを設定します。ALB は OPTIONS プリフライトリクエストを自動的に処理し、CORS レスポンスヘッダーを返します。その結果、バックエンドサーバーは CORS リクエストを処理する必要がなくなります。CORS アクションは、ヘッダーの追加 アクションを使用して Access-Control-Allow-Origin などのレスポンスヘッダーを手動で設定するよりも設定が簡単です。

  CORS とは？

  クロスオリジンリクエストとは、現在のページとは異なるオリジン (ドメイン、プロトコル、またはポート) からのリソースを要求することです。リクエストには、単純リクエストとプリフライトリクエストがあります。CORS アクションは、フロントエンドとバックエンドのサービスが分離されているシナリオに適しています。たとえば、フロントエンドが www.example.com にデプロイされ、API サービスが api.example.com にデプロイされている場合、フロントエンドがブラウザから API を呼び出すと、クロスオリジン制限に抵触します。

  • [許可された配信元]：ブラウザからのリソースアクセスを許可するオリジンを指定します。

  • [許可されたメソッド]：クロスオリジンリクエストで許可される HTTP メソッドを選択します。有効な値：GET、POST、PUT、DELETE、HEAD、OPTIONS、PATCH。

  • [許可されたリクエストヘッダー]：ブラウザがサポートする基本ヘッダーに加えて、クロスオリジンリクエストで許可されるヘッダーを指定します。

  • [許可されたレスポンスヘッダー]：ブラウザや JavaScript がアクセスできるレスポンスヘッダーを指定します。

  • [資格情報を許可]：クロスオリジンリクエストに認証情報を含めることを許可するかどうかを指定します。デフォルト値は 許可 です。

  • [ブラウザーキャッシュ時間]：プリフライトリクエストの場合、OPTIONS プリフライトリクエストの結果をブラウザにキャッシュできる最大期間を指定します。単位：秒。有効な値：-1～172800。

[ルール名]

任意。このパラメーターを空のままにすると、システムが自動的に名前を生成します。

[インバウンド条件 (オプション)：]

1 つ以上のインバウンド条件を選択します。また、インバウンド条件の追加 をクリックして、複数の条件を追加することもできます。各条件の設定方法については、「インバウンドルール」タブをご参照ください。

インバウンド転送ルールで 書き換え アクションを設定した場合、アウトバウンド転送ルールに追加するインバウンド条件 (ドメイン名、パス、クエリ文字列 など) は、クライアントリクエストの元の値ではなく、書き換えられた値と一致する必要があります。たとえば、インバウンドルールがパスを /app/page から /v2/page に書き換える場合、アウトバウンドルールのパス条件を /v2/page に設定する必要があります。

[アウトバウンド条件]

1 つ以上のアウトバウンド条件を選択します。また、アウトバウンド条件の追加 をクリックして、複数の条件を追加することもできます。

• [レスポンスステータスコード]：クライアントへのレスポンスのステータスコード。有効な値：100～599。範囲を指定できます。複数のステータスコードと範囲はカンマ (,) で区切ります。例：200-233,301。

• [レスポンスヘッダー]：バックエンドレスポンスの HTTP ヘッダー。キー フィールドに HTTP ヘッダー名を入力し、値 フィールドにその値を入力します。複数のヘッダーを追加できます。

[転送操作]

アウトバウンドのアクションタイプを選択します。また、操作の追加 をクリックして、複数のアクションを追加することもできます。

• [固定レスポンスを返す]：レスポンスステータスコード を入力します。応答コンテンツタイプ (オプション) と 応答コンテンツ (オプション) を指定することもできます。レスポンスステータスコードは、2xx、4xx、または 5xx 形式の数字の文字列である必要があります。ここで x は数字を表します。

• [ヘッダーの追加]：アウトバウンドのヘッダー名と値を入力します。このアクションは、同じ名前の既存のレスポンスヘッダーを上書きします。

• [ヘッダーの削除]：アウトバウンドのヘッダー名を入力して、レスポンスから対応するキーと値のペアを削除します。

  アウトバウンドの ヘッダーの追加 および ヘッダーの削除 アクションを使用する場合、以下のヘッダー名は指定できません。一致では大文字と小文字は区別されません。これらのヘッダーは HTTP プロトコルにおいて重要です。これらを変更すると、レスポンス送信に問題が発生する可能性があります。connection、upgrade、content-length、transfer-encoding。