仮想ルーター

重要

サポート終了通知: 2026 年 9 月 30 日、 AWS はサポートを終了します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事「 から Amazon ECS Service Connect AWS App Mesh への移行」を参照してください。

仮想ルーターは、メッシュ内の 1 つ以上の仮想サービスのトラフィックを処理します。仮想ルーターを作成したら、受信リクエストを別の仮想ノードに送る仮想ルーターのルートを作成して関連付けることができます。

仮想ルーターが期待するすべてのインバウンドトラフィックは、リスナーとして指定する必要があります。

仮想ルーターの作成

AWS Management Console

を使用して仮想ルーターを作成するには AWS Management Console

注記

仮想ルーターを作成するときは、作成した仮想ルーターにルートを関連付ける名前空間のリストを識別するラベル付きの名前空間セレクターを追加する必要があります。

1. App Mesh コンソールを https://console.aws.amazon.com/appmesh/ で開きます。

2. 仮想ルーターを作成するメッシュを選択します。所有しているメッシュや、共有されているメッシュがすべて一覧表示されます。

3. 左側のナビゲーションで [仮想ルーター] を選択します。

4. [仮想ルーターの作成] を選択します。

5. [仮想ルーター名] に仮想ルーターの名前を指定します。最大 255 文字の英字、数字、ハイフン、アンダースコアを使用できます。

6. (オプション) [リスナー] 設定には、仮想ルーターの [ポート] および [プロトコル] を指定します。http リスナーは、ウェブソケットへの接続移行を許可します。[リスナーの追加] をクリックすると、複数のリスナーを追加できます。[削除] ボタンをクリックすると、そのリスナーが削除されます。

7. [仮想ルーターの作成] を選択して終了します。

AWS CLI

AWS CLIを使用して仮想ルータを作成するには

以下のコマンドと入力 JSON ファイル (赤色の値を独自の値に置き換えてください) を使用して、仮想ルーターを作成します。

1. aws appmesh create-virtual-router \
        --cli-input-json file://create-virtual-router.json

2. create-virtual-router.json の例の内容:

3. {
       "meshName": "meshName",
       "spec": {
           "listeners": [
               {
                   "portMapping": {
                       "port": 80,
                       "protocol": "http"
                   }
               }
           ]
       },
       "virtualRouterName": "routerName"
   }

4. 出力例:

   {
       "virtualRouter": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName",
               "createdAt": "2022-04-06T11:49:47.216000-05:00",
               "lastUpdatedAt": "2022-04-06T11:49:47.216000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 80,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualRouterName": "routerName"
       }
   }
   

App Mesh AWS CLI の を使用して仮想ルーターを作成する方法の詳細については、 AWS CLI リファレンスの create-virtual-router コマンドを参照してください。

仮想ルーターを削除する

注記

ルートがある場合、または、それが仮想サービスのプロバイダーとして指定されている場合は、仮想ルーターを削除できません。

AWS Management Console

を使用して仮想ルーターを削除するには AWS Management Console

1. App Mesh コンソールをhttps://console.aws.amazon.com/appmesh/で開きます。

2. 仮想ルーターを削除するメッシュを選択します。所有しているメッシュや、共有されているメッシュがすべて一覧表示されます。

3. 左側のナビゲーションで [仮想ルーター] を選択します。

4. [仮想ルーター] テーブルで、削除する仮想ルーターを選択し、[削除] を選択します。仮想ルーターを削除するには、仮想ルーターのメッシュ所有者またはリソース所有者のいずれかの列にアカウント ID が一覧表示されている必要があります。

5. 確認ボックスで、「delete」と入力し、[削除] をクリックします。

AWS CLI

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

1. 以下のコマンドを使用して仮想ルーターを削除します (赤色の値を独自の値に置き換えてください)。

   aws appmesh delete-virtual-router \
        --mesh-name meshName \
        --virtual-router-name routerName

2. 出力例:

   {
       "virtualRouter": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:210987654321:mesh/meshName/virtualRouter/routerName",
               "createdAt": "2022-04-06T11:49:47.216000-05:00",
               "lastUpdatedAt": "2022-04-07T10:49:53.402000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "210987654321",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 80,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "DELETED"
           },
           "virtualRouterName": "routerName"
       }
   }
   

App Mesh AWS CLI の を使用して仮想ルーターを削除する方法の詳細については、 AWS CLI リファレンスの delete-virtual-router コマンドを参照してください。