Requesting a Connection

You can request a DirectLink connection to connect your network to a specified DirectLink location, where you must have a router or a fiber-optic cable linked to your network. This connection then enables you to reach your resources in the whole Region associated with this location. If your resources are placed in only one Subregion of a Region, we recommend to create a connection between your network and the corresponding location to reduce latency.

Once you request the connection, 3DS OUTSCALE sends you a Letter of Authorization (LOA) by email to allow you to connect to the corresponding DirectLink router. You must then configure the connection with one or more DirectLink interfaces to access your Nets using the DirectLink connection.

Requesting a Connection Using Cockpit v2

  1. In the DirectLink dashboard, click IconAddFull Create DirectLink connection.
    The CREATE DIRECTLINK CONNECTION dialog box appears.

  2. In the Name field, type the name of the connection.

  3. From the Location list, select the location for the connection. For more information, see Getting Information About DirectLink Locations.

  4. From the Bandwidth list, select the bandwidth for the connection.

  5. Click Create.
    The request for the connection is sent to 3DS OUTSCALE.

Requesting a Connection Using OSC CLI

The CreateDirectLink command creates a DirectLink between a customer network and a specified DirectLink location.

For more information, see About DirectLink.

Request sample
$ osc-cli api CreateDirectLink --profile "default" \
    --Location "PAR1" \
    --Bandwidth "1Gbps" \
    --DirectLinkName "Connection to Outscale"

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

  • Bandwidth: The bandwidth of the DirectLink (1Gbps | 10Gbps).

  • DirectLinkName: The name of the DirectLink.

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Location: The code of the requested location for the DirectLink, returned by the ReadLocations method.

The CreateDirectLink command returns the following elements:

  • DirectLink: Information about the DirectLink.

  • ResponseContext: Information about the context of the response.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "DirectLink": {
    "AccountId": "123456789012",
    "Bandwidth": "1Gbps",
    "DirectLinkId": "dxcon-12345678",
    "DirectLinkName": "Connection to Outscale",
    "Location": "PAR1",
    "RegionName": "eu-west-2",
    "State": "requested"
  }
}

Requesting a Connection Using AWS CLI

To request a connection, use the create-connection command following this syntax:

Request sample
$ aws directconnect create-connection \
    --profile YOUR_PROFILE \
    --location PAR1 \
    --bandwidth 1Gbps \
    --connection-name Connection to Outscale \
    --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.

  • location: The code of the requested location for the connection. For more information, see Getting Information About DirectLink Locations.

  • bandwidth: The bandwidth for the connection (1Gbps or 10Gbps).

  • connection-name: The name of the connection.

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

The create-connection command returns the following elements:

  • ownerAccount: The account ID of the owner of the requested connection.

  • connectionID: The ID of the connection.

  • connectionState: The state of the connection. For more information, see About DirectLink.

  • bandwidth: The bandwidth for the connection (1 Gbps or 10 Gbps).

  • location: The location where the connection is located.

  • connectionName: The name of the connection.

  • region: The Region where the connection is located.

Result sample
{
    "ownerAccount": "123456789000",
    "connectionId": "dxcon-12345678",
    "connectionState": "requested",
    "bandwidth": "1Gbps",
    "location": "PAR1",
    "connectionName": "Connection to Outscale",
    "region": "eu-west-2"
}

The connection request is sent to 3DS OUTSCALE.

Related Pages

Corresponding API Methods

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

Export to PDF