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

In the DirectLink dashboard, click Create DirectLink connection.
The CREATE DIRECTLINK CONNECTION dialog box appears.
In the Name field, type the name of the connection.
From the Location list, select the location for the connection. For more information, see Getting Information About DirectLink Locations.
From the Bandwidth list, select the bandwidth for the connection.
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.
- AccountId: The account ID of the owner of the DirectLink.
- Bandwidth: The physical link bandwidth (either 1 Gbps or 10 Gbps).
- DirectLinkId: The ID of the DirectLink (for example, dxcon-xxxxxxxx).
- DirectLinkName: The name of the DirectLink.
- Location: The datacenter where the DirectLink is located.
- RegionName: The Region in which the DirectLink has been created.
- State: The state of the DirectLink.
requested: The DirectLink is requested but the request has not been validated yet.
pending: The DirectLink request has been validated. It remains in the pending state until you establish the physical link.
available: The physical link is established and the connection is ready to use.
deleting: The deletion process is in progress.
deleted: The DirectLink is deleted.
ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

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 oapi-cli

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

For more information, see About DirectLink.

Request sample

$ oapi-cli --profile "default" CreateDirectLink \
    --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.
- AccountId: The account ID of the owner of the DirectLink.
- Bandwidth: The physical link bandwidth (either 1 Gbps or 10 Gbps).
- DirectLinkId: The ID of the DirectLink (for example, dxcon-xxxxxxxx).
- DirectLinkName: The name of the DirectLink.
- Location: The datacenter where the DirectLink is located.
- RegionName: The Region in which the DirectLink has been created.
- State: The state of the DirectLink.
requested: The DirectLink is requested but the request has not been validated yet.
pending: The DirectLink request has been validated. It remains in the pending state until you establish the physical link.
available: The physical link is established and the connection is ready to use.
deleting: The deletion process is in progress.
deleted: The DirectLink is deleted.
ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

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

Before you begin: Install and configure AWS CLI. For more information, see Installing and Configuring 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. For more information, see Installing and Configuring AWS CLI.

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.