View a markdown version of this page

BGP route visibility - Amazon Direct Connect
BGP route visibility conceptsView BGP routes
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

BGP route visibility

With Amazon Direct Connect, you can view the BGP routes on your virtual interfaces (VIFs). You can see which routes Amazon accepted from your router. You can also see which routes Amazon is sending to your router. Each route shows its AS path and community values.

View routes in the Amazon Direct Connect console, or use the ListVirtualInterfaceRoutes API action. For more information about the API, see ListVirtualInterfaceRoutes in the Amazon Direct Connect API Reference.

BGP route visibility concepts

Accepted routes and advertised routes

Each route has a direction:

  • Accepted routes – Routes that Amazon received from your router. Amazon keeps these routes after it applies inbound routing policy.

  • Advertised routes – Routes that Amazon sends to your router over the VIF.

Route age

Each route includes the time that Amazon received or advertised it on the virtual interface. The console shows this as the route age. In the API and Amazon CLI response, the value is an epoch-seconds timestamp; to find the route age, subtract this value from the current time.

Communities

Routes show their BGP community values in ASN:value format. Amazon shows only the supported Direct Connect communities and hides all other (internal) community values. The supported communities are:

  • Scope communities (advertised to your router): 7224:9100, 7224:9200, and 7224:9300.

  • Region and continent communities (accepted from your router): 7224:8100 and 7224:8200.

  • Local preference communities (accepted from your router): 7224:7100, 7224:7200, and 7224:7300.

The communities that appear depend on the VIF type and route direction. For more information about these communities and how Amazon uses them, see Routing policies and BGP communities.

View BGP routes

The Amazon Direct Connect console shows BGP route data on the virtual interface detail page. Choose the Accepted routes or Advertised routes tab to see routes.

Each route tab shows a table with the following columns:

  • Prefix/Network

  • Address family

  • AS path

  • Communities

  • Route age

You can filter routes by prefix, AS path, community, or address family.

Console
To view BGP routes for a virtual interface

  1. Open the Amazon Direct Connect console at https://console.amazonaws.cn/directconnect/v2/home.

  2. In the navigation pane, choose Virtual Interfaces.

  3. Select the virtual interface.

  4. Choose the Accepted routes or Advertised routes tab to view the corresponding routes.

Command line

Use the list-virtual-interface-routes command. Use the routeDirection filter to return accepted or advertised routes. The following example returns the routes that Amazon accepted from your router on the specified virtual interface.

aws directconnect list-virtual-interface-routes \
    --virtual-interface-id dxvif-abc12345 \
    --filters '{"routeDirection": "accepted"}'

You can also filter the results by address family (addressFamily), prefix (cidrs), AS path (asPath), or community (communities).