VPC Lattice サービスのリスナールール - Amazon VPC Lattice
デフォルトのルールルールの優先順位ルールアクションルールの条件ルールの追加ルールを更新するルールの削除

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

VPC Lattice サービスのリスナールール

各リスナーにはデフォルトのルールと、定義できる追加のルールがあります。各ルールは優先度、1 つ以上のアクション、および 1 つ以上の条件で構成されています。ルールの追加や編集はいつでも行うことができます。

デフォルトのルール

リスナーを作成するときは、デフォルトのルールのアクションを定義します。デフォルトのルールに条件を定義することはできません。リスナーのルールに設定された条件のいずれも満たされない場合は、デフォルトのルールのアクションが実行されます。

ルールの優先順位

各ルールには優先順位があります。ルールは優先順位の低~高順によって評価されます。デフォルトのルールが最後に評価されます。デフォルト以外のルールの優先度はいつでも変更できます。デフォルトルールの優先順位は変更できません。

ルールアクション

VPC Lattice サービスのリスナーは、転送アクションと固定レスポンスアクションをサポートしています。

転送アクション

forward アクションを使用して、1 つ以上の VPC Lattice ターゲットグループにリクエストをルーティングできます。forward アクションに複数のターゲットグループを指定する場合は、ターゲットグループごとに重みを指定する必要があります。各ターゲットグループの重みは、0～999 の値です。加重ターゲットグループを持つリスナールールと一致するリクエストは、それらの重みに基づいてこれらのターゲットグループに分散されます。たとえば、ターゲットグループを 2 つ指定し、それぞれ重みが 10 の場合、各ターゲットグループはリクエストの半分を受け取ります。2 つのターゲットグループ (1 つは重みが 10 で、もう 1 つは重みが 20) を指定すると、重みが 20 のターゲットグループは他のターゲットグループの 2 倍の数のリクエストを受信します。

固定レスポンスアクション

クライアントリクエストを破棄し、カスタムの HTTP レスポンスを返すには、fixed-response アクションを使用します。このアクションを使用して 404 レスポンスコードを返せます。

例 の固定レスポンスアクションの例 AWS CLI

ルールの作成時または更新時にアクションを指定できます。次のアクションは指定されたステータスコードを含む固定レスポンスを送信します。

"action": { 
    "fixedResponse": { 
        "statusCode": 404
},

ルールの条件

ルールのアクションごとにタイプと設定情報があります。ルールの条件が満たされると、アクションが実行されます。

ルールでは次の一致基準がサポートされています。

ヘッダー一致

各リクエストの HTTP ヘッダーに基づきルーティングされます。HTTP ヘッダー条件を使用して、リクエストの HTTP ヘッダーに基づいてリクエストをルーティングするルールを設定できます。標準またはカスタムの HTTP ヘッダーフィールドの名前を指定できます。ヘッダー名と一致評価では大文字と小文字は区別されません。この設定を変更するには、大文字と小文字の区別をオンにします。ワイルドカード文字はヘッダー名ではサポートされていません。ヘッダー一致ではプレフィックス、完全一致、部分一致がサポートされています。

メソッド一致

各リクエストの HTTP リクエストメソッドに基づきルーティングされます。

HTTP リクエストメソッド条件を使用して、リクエストの HTTP リクエストメソッドに基づいてリクエストをルーティングするルールを設定できます。標準またはカスタムの HTTP メソッドを指定できます。メソッド一致では大文字と小文字は区別されます。メソッド名は完全に一致する必要があります。ワイルドカード文字はサポートされていません。

パス一致

リクエスト URL のパスパターンの一致に基づきルーティングされます。

パスの条件を使用して、リクエスト内の URL に基づいてリクエストをルーティングするルールを定義できます。ワイルドカード文字はサポートされていません。パス一致ではプレフィックスと完全一致がサポートされています。

ルールの追加

リスナールールはいつでも追加できます。

コンソールを使用してリスナールールを追加する場合

  1. Amazon VPC コンソール (https://console.aws.amazon.com/vpc/) を開きます。

  2. ナビゲーションペインの [VPC Lattice] で、[サービス] を選択します。

  3. サービスの名前を選択して、その詳細ページを開きます。

  4. [ルーティング] タブで [リスナーを編集] を選択します。

  5. [リスナールール] を展開し、[ルールを追加] を選択します。

  6. [ルール名] にルールの名前を入力します。

  7. [優先度] には 1 から 100 までの優先度を入力します。ルールは優先順位の低~高順によって評価されます。デフォルトのルールが最後に評価されます。

  8. [条件] にはパス一致条件のパスパターンを入力します。各文字列の最大サイズは 200 文字です。比較では、大文字と小文字は区別されません。ワイルドカード文字はサポートされていません。

    ヘッダー一致またはメソッド一致ルール条件を追加するには、 AWS CLI または AWS SDK を使用します。

  9. [アクション] では、VPC Lattice ターゲットグループを選択します。

  10. [変更の保存] を選択します。

を使用してルールを追加するには AWS CLI

create-rule コマンドを使用します。

ルールを更新する

リスナールールはいつでも更新できます。優先度、条件、ターゲットグループ、各ターゲットグループの重み付けを変更できます。ルールの名前は変更できません。

コンソールを使用してリスナールールを更新する場合

  1. Amazon VPC コンソール (https://console.aws.amazon.com/vpc/) を開きます。

  2. ナビゲーションペインの [VPC Lattice] で、[サービス] を選択します。

  3. サービスの名前を選択して、その詳細ページを開きます。

  4. [ルーティング] タブで [リスナーを編集] を選択します。

  5. 必要に応じて、ルールの優先度、条件、アクションを変更します。

  6. 更新内容を確認して [変更を保存] をクリックします。

を使用してルールを更新するには AWS CLI

update-rule コマンドを使用します。

ルールの削除

リスナーのデフォルト以外のルールはいつでも削除できます。リスナーのデフォルトのルールは削除できません。リスナーを削除すると、そのルールはすべて削除されます。

コンソールを使用してリスナールールを削除する場合

  1. Amazon VPC コンソール (https://console.aws.amazon.com/vpc/) を開きます。

  2. ナビゲーションペインの [VPC Lattice] で、[サービス] を選択します。

  3. サービスの名前を選択して、その詳細ページを開きます。

  4. [ルーティング] タブで [リスナーを編集] を選択します。

  5. ルールを見つけ、[削除] をクリックします。

  6. [変更の保存] を選択します。

を使用してルールを削除するには AWS CLI

delete-rule コマンドを使用します。