翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# VPC Lattice サービスのリスナールール
各リスナーにはデフォルトのルールと、定義できる追加のルールがあります。各ルールは優先度、1 つ以上のアクション、および 1 つ以上の条件で構成されています。ルールの追加や編集はいつでも行うことができます。
**Topics**
+ [デフォルトのルール](#listener-default-rule)
+ [ルールの優先順位](#listener-rule-priority)
+ [ルールアクション](#listener-rule-actions)
+ [ルールの条件](#listener-rule-conditions)
+ [ルールの追加](#add-rules)
+ [ルールを更新する](#update-rules)
+ [ルールの削除](#delete-rules)
## デフォルトのルール
リスナーを作成するときは、デフォルトのルールのアクションを定義します。デフォルトのルールに条件を定義することはできません。リスナーのルールに設定された条件のいずれも満たされない場合は、デフォルトのルールのアクションが実行されます。
## ルールの優先順位
各ルールには優先順位があります。ルールは優先順位の低\$1高順によって評価されます。デフォルトのルールが最後に評価されます。デフォルト以外のルールの優先度はいつでも変更できます。デフォルトルールの優先順位は変更できません。
## ルールアクション
VPC Lattice サービスのリスナーは、転送アクションと固定レスポンスアクションをサポートしています。
### 転送アクション
`forward` アクションを使用して、1 つ以上の VPC Lattice ターゲットグループにリクエストをルーティングできます。`forward` アクションに複数のターゲットグループを指定する場合は、ターゲットグループごとに重みを指定する必要があります。各ターゲットグループの重みは、0～999 の値です。加重ターゲットグループを持つリスナールールと一致するリクエストは、それらの重みに基づいてこれらのターゲットグループに分散されます。たとえば、ターゲットグループを 2 つ指定し、それぞれ重みが 10 の場合、各ターゲットグループはリクエストの半分を受け取ります。2 つのターゲットグループ (1 つは重みが 10 で、もう 1 つは重みが 20) を指定すると、重みが 20 のターゲットグループは他のターゲットグループの 2 倍の数のリクエストを受信します。
### 固定レスポンスアクション
クライアントリクエストを破棄し、カスタムの HTTP レスポンスを返すには、`fixed-response` アクションを使用します。このアクションを使用して、404 または 500 レスポンスコードを返すことができます。
**Example の固定レスポンスアクションの例 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/](https://console.aws.amazon.com/vpc/) を開いてください。
1. ナビゲーションペインの **[VPC Lattice]** で、**[サービス]** を選択します。
1. サービスの名前を選択して、その詳細ページを開きます。
1. **[ルーティング]** タブで **[リスナーを編集]** を選択します。
1. **[リスナールール]** を展開し、**[ルールを追加]** を選択します。
1. [**ルール名**] にルールの名前を入力します。
1. **[優先度]** には 1 から 100 までの優先度を入力します。ルールは優先順位の低\$1高順によって評価されます。デフォルトのルールが最後に評価されます。
1. **[条件]** にはパス一致条件のパスパターンを入力します。各文字列の最大サイズは 200 文字です。比較では、大文字と小文字は区別されません。ワイルドカード文字はサポートされていません。
ヘッダー一致またはメソッド一致ルール条件を追加するには、 AWS CLI または AWS SDK を使用します。
1. **[アクション]** では、VPC Lattice ターゲットグループを選択します。
1. **[Save changes]** (変更の保存) をクリックします。
**を使用してルールを追加するには AWS CLI**
[create-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/create-rule.html) コマンドを使用します。
## ルールを更新する
リスナールールはいつでも更新できます。優先度、条件、ターゲットグループ、各ターゲットグループの重み付けを変更できます。ルールの名前は変更できません。
**コンソールを使用してリスナールールを更新する場合**
1. Amazon VPC コンソールの [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) を開いてください。
1. ナビゲーションペインの **[VPC Lattice]** で、**[サービス]** を選択します。
1. サービスの名前を選択して、その詳細ページを開きます。
1. **[ルーティング]** タブで **[リスナーを編集]** を選択します。
1. 必要に応じて、ルールの優先度、条件、アクションを変更します。
1. 更新内容を確認して **[変更を保存]** をクリックします。
**を使用してルールを更新するには AWS CLI**
[update-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/update-rule.html) コマンドを使用します。
## ルールの削除
リスナーのデフォルト以外のルールはいつでも削除できます。リスナーのデフォルトのルールは削除できません。リスナーを削除すると、そのルールはすべて削除されます。
**コンソールを使用してリスナールールを削除する場合**
1. Amazon VPC コンソールの [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) を開いてください。
1. ナビゲーションペインの **[VPC Lattice]** で、**[サービス]** を選択します。
1. サービスの名前を選択して、その詳細ページを開きます。
1. **[ルーティング]** タブで **[リスナーを編集]** を選択します。
1. ルールを見つけ、**[削除]** をクリックします。
1. **[Save changes]** (変更の保存) をクリックします。
**を使用してルールを削除するには AWS CLI**
[delete-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/delete-rule.html) コマンドを使用します。