AWS App Mesh
User Guide

Virtual Routers

Virtual routers handle traffic for one or more virtual services within your mesh. After you create a virtual router, you can create and associate routes for your virtual router that direct incoming requests to different virtual nodes.

Any inbound traffic that your virtual router expects should be specified as a listener.

Creating a Virtual Router

To create a virtual router using the AWS Management Console, complete the following steps. To create a virtual router using the AWS CLI version 1.16.266 or higher, see the example in the AWS CLI reference for the create-virtual-router command.

  1. Open the App Mesh console at https://console.aws.amazon.com/appmesh/.

  2. Choose the mesh that you want to create the virtual router in.

  3. Choose Virtual routers in the left navigation.

  4. Choose Create virtual router.

  5. For Virtual router name, specify a name for your virtual router. Up to 255 letters, numbers, hyphens, and underscores are allowed.

  6. For Listener, specify a Port and Protocol for your virtual router.

  7. Choose Create virtual router to finish.

Deleting a Virtual Router

To delete a virtual router using the AWS Management Console complete the following steps. To delete a virtual router using the AWS CLI, use the aws appmesh delete-virtual-router command. For an example of deleting a virtual router using the AWS CLI, see delete-virtual-router.

Note

You cannot delete a virtual router if it has any routes or if it is specified as a provider for any virtual service.

  1. Open the App Mesh console at https://console.aws.amazon.com/appmesh/.

  2. Choose the mesh that you want to delete a virtual router from.

  3. Choose Virtual routers in the left navigation.

  4. In the Virtual Routers table, choose the virtual router that you want to delete and select Delete.

  5. In the confirmation box, type delete and then select Delete.