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 レスポンスコードを返せます。

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

ルールの条件

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

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

ルールの追加

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

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

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

ルールを更新する

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

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

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

ルールの削除

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

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

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