Creating a Private Virtual Interface

You can create one or more private virtual interfaces to send traffic to Virtual Private Clouds (VPCs) using a DirectLink connection. You need to create one private virtual interface per VPC you want to reach, which partitions your connection using VLAN IDs.

You must then configure your router with the information returned by this action to enable the private virtual interface to forward traffic to the corresponding VPC through the connection. The security group of this VPC must also allow traffic coming from your internal network.

Your router must also be configured with the Autonomous System Number (ASN) of 3DS OUTSCALE. For more information, see About DirectLink > General Information About DirectLink Connections.

Creating a Private Virtual Interface Using Cockpit

  1. Click Network/Security > Virtual Interfaces.

  2. Click Create .
    The CREATE VIRTUAL INTERFACES dialog box appears.

  3. From the Connection list, select a DirectLink connection for the virtual interface.

  4. In the Name field, type a name for the private virtual interface.

  5. In the VLAN field, type the VLAN for the private virtual interface.

  6. In the ASN field, type the ASN for the private virtual interface.

  7. From the Virtual private gateway list, select a virtual private gateway.

  8. Click Create to validate.
    The private virtual interface is created and appears on the Virtual Interfaces page.

Creating a Private Virtual Interface Using AWS CLI

To create a private virtual interface, use the create-private-virtual-interface command following this syntax:

Request sample
$ aws directconnect create-private-virtual-interface \
    --profile YOUR_profile \
    --connection-id dxcon-12345678 \
    --new-private-virtual-interface virtualInterfaceName=MyPrivateVirtualInterface,vlan=101,asn=65000,authKey=tgyn26example,amazonAddress=172.16.0.1/30,customerAddress=172.16.0.2/30),virtualGatewayId=vgw-87654321 \
    --endpoint https://directlink.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • connection-id: The ID of the connection you want to use.

    The connection must be in the available state. For more information, see About DirectLink > General Information About DirectLink Connections.

  • new-private-virtual-interface: Information about the private virtual interface to create. This attribute contains the following elements that you need to specify:

    • virtualInterfaceName: The name of the private virtual interface.

    • vlan: The unique VLAN ID for the private virtual interface (an integer between 1 and 4096).

    • asn: The ASN for the Border Gateway Protocol (BGP) configuration.

    • (optional) authKey: The authentication key for the BGP configuration.

    • (optional) amazonAddress: The IP on the OUTSCALE side of the virtual interface, in /30 CIDR notation (for example, 172.16.0.1/30).

    • (optional) customerAddress: The IP on the customer side of the virtual interface, in /30 CIDR notation (for example, 172.16.0.2/30).

      You must provide a customerAddress if you provide an amazonAddress. This IP must be in the same network subnet than the one specified for the DirectLink router.

    • virtualGatewayId: The ID of the target virtual private gateway. For more information about how to get information about your virtual private gateways you can use, see Getting Information About Your Virtual Private Gateways for DirectLink.

      The target virtual private gateway must be available and attached to a VPC.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The create-private-virtual-interface command returns the following elements:

  • virtualInterfaceState: The state of the private virtual interface.

  • asn: The BGP ASN on the customer side of the virtual interface.

  • vlan: The unique VLAN ID for the private virtual interface.

  • customerAddress: The IP on the customer side of the virtual interface.

  • ownerAccount: The account ID of the owner of the private virtual interface.

  • connectionID: The ID of the connection.

  • virtualGatewayId: The ID of the virtual private gateway.

  • virtualInterfaceId: The ID of the private virtual interface.

  • authKey: The BGP authentication key.

  • location: The datacenter where the connection is.

  • amazonAddress: The IP on the OUTSCALE side of the virtual interface.

  • virtualInterfaceType: The type of virtual interface (always private).

  • virtualInterfaceName: The name of the virtual interface.

Result sample
{
    "virtualInterfaceState": "pending",
    "asn": 65000,
    "vlan": 101,
    "customerAddress": "172.16.0.2/30",
    "ownerAccount": "123456789000",
    "connectionId": "dxcon-12345678",
    "virtualGatewayId": "vgw-87654321",
    "virtualInterfaceId": "dxvif-56781234",
    "authKey": "tgyn26example",
    "routeFilterPrefixes": [],
    "location": "PAR1",
    "amazonAddress": "172.16.0.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "MyPrivateVirtualInterface"
}

The private virtual interface is created.

Related Pages

Corresponding API Method

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.