Creating a Hosted Private Virtual Interface

You can create a private virtual interface hosted in the account of another OUTSCALE user. This enables this other user, the recipient, to use your DirectLink connection to access one of their Virtual Private Clouds (VPCs).

The recipient needs to accept your request of creation of a private virtual interface before they can use it. They then become the owner of the private virtual interface. Until it is accepted, the private virtual interface cannot forward traffic. For more information, see Accepting a Hosted Private Virtual Interface.

For more information about private virtual interfaces, see About DirectLink > DirectLink Connections and Private Virtual Interfaces.

This feature is not available from Cockpit. This documentation only describes the procedure using AWS CLI.

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

Request sample
$ aws directconnect allocate-private-virtual-interface \
    --profile YOUR_profile \
    --connection-id dxcon-12345678 \
    --owner-account 123456789000 \
    --new-private-virtual-interface-allocation virtualInterfaceName=MyPrivateVirtualInterface,vlan=101,asn=65000,authKey=tgyn26example,amazonAddress=172.16.0.1/30,customerAddress=172.16.0.2/30) \
    --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.

  • owner-account: The account ID of the owner of the private virtual interface to create.

  • new-private-virtual-interface-allocation: 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 autonomous system number (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 private virtual interface, in /30 CIDR notation (for example, 172.16.0.1/30).

    • (optional) customerAddress: The IP on the customer side of the private 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 as the one specified for the DirectLink router.

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

The allocate-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.

  • virtualInterfaceId: The ID of the private virtual interface.

  • authKey: The BGP authentication key.

  • location: The datacenter where the connection is located.

  • 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": "confirming",
    "asn": 65000,
    "vlan": 101,
    "customerAddress": "172.16.0.2/30",
    "ownerAccount": "123456789000",
    "connectionId": "dxcon-12345678",
    "virtualInterfaceId": "dxvif-56781234",
    "authKey": "tgyn26example",
    "location": "PAR1",
    "amazonAddress": "172.16.0.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "MyPrivateVirtualInterface"
}

The private virtual interface is created.

The private virtual interface remains in the confirming state and cannot forward traffic until its owner confirms it. For more information, see Accepting a Hosted Private Virtual Interface.

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.