CmdID / aws / aws directconnect
aws directconnect describe-virtual-interfaces
Displays all virtual interfaces for an Amazon Web Services account. AWS CLI reference
1 example 4 options Its page in the AWS CLI reference
Examples
To list all virtual interfaces
The following describe-virtual-interfaces example lists the information about all virtual interfaces associated with your AWS account.
aws directconnect describe-virtual-interfaces --connection-id dxcon-ffjrkx17Identify--connection-idThe ID of the connection.Its output, shortened
{
"virtualInterfaces": [
{
"virtualInterfaceState": "down",
"asn": 65000,
"vlan": 101,
"customerAddress": "192.168.1.2/30",
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffjrkx17",
"virtualGatewayId": "vgw-aba37db6",
"virtualInterfaceId": "dxvif-ffhhk74f",
"authKey": "asdf34example",
"routeFilterPrefixes": [],
"location": "TIVIT",
"customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-ffhhk74f\">\n <vlan>101</vlan>\n <customer_address>192.168.1.2/30</customer_address>\n <amazon_address>192.168.1.1/30</amazon_address>\n <bgp_asn>65000</bgp_asn>\n <bgp_auth_key>asdf34example</bgp_auth_key>\n <amazon_bgp_asn>7224</amazon_bgp_asn>\n <connection_type>private</connection_type>\n</logical_connection>\n",
"amazonAddress": "192.168.1.1/30",
"virtualInterfaceType": "private",
"virtualInterfaceName": "PrivateVirtualInterface"
},
{
"virtualInterfaceState": "verifying",
"asn": 65000,
"vlan": 2000,
"customerAddress": "203.0.113.2/30",
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffjrkx17",
"virtualGatewayId": "",
"virtualInterfaceId": "dxvif-fgh0hcrk",
"authKey": "asdf34example",
"routeFilterPrefixes": [
… 15 more linesFor more information, see View Direct Connect virtual interface details in the AWS Direct Connect User Guide.
Options
--connection-idThe ID of the connection.--max-resultsThe maximum number of results to return with a single call.--next-tokenThe token for the next page of results.--virtual-interface-idThe ID of the virtual interface.