Getting Information About DirectLink Locations

You can get information about available DirectLink locations. You can then request a connection between one of these locations and your own network.

Getting Information About DirectLink Locations Using Cockpit

See the DirectLink Connections dashboard.

Getting Information About DirectLink Locations Using OSC CLI

The ReadLocations command lists the locations, corresponding to datacenters, where you can set up a DirectLink.

For more information, see About DirectLink.

Request sample
$ osc-cli api ReadLocations --profile "default"

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

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

  • NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.

  • ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1 and 1000, both included).

The ReadLocations command returns the following elements:

  • Locations: Information about one or more locations.

    • Code: The location code, to be set as the Location parameter of the CreateDirectLink method when creating a DirectLink.

    • Name: The name and description of the location, corresponding to a datacenter.

  • NextPageToken: The token to request the next page of results. Each token refers to a specific page.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Locations": [
    {
      "Name": "Telehouse 3, France",
      "Code": "PAR1"
    },
    {
      "Name": "Equinix Pantin, France",
      "Code": "PAR4"
    }
  ]
}

Getting Information About DirectLink Locations Using oapi-cli

The ReadLocations command lists the locations, corresponding to datacenters, where you can set up a DirectLink.

For more information, see About DirectLink.

Request sample
$ oapi-cli --profile "default" ReadLocations

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

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

  • NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.

  • ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1 and 1000, both included).

The ReadLocations command returns the following elements:

  • Locations: Information about one or more locations.

    • Code: The location code, to be set as the Location parameter of the CreateDirectLink method when creating a DirectLink.

    • Name: The name and description of the location, corresponding to a datacenter.

  • NextPageToken: The token to request the next page of results. Each token refers to a specific page.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Locations": [
    {
      "Name": "Telehouse 3, France",
      "Code": "PAR1"
    },
    {
      "Name": "Equinix Pantin, France",
      "Code": "PAR4"
    }
  ]
}

Getting Information About DirectLink Locations Using AWS CLI

Before you begin: Install and configure AWS CLI. For more information, see Installing and Configuring AWS CLI.

To get information about DirectLink locations, use the describe-locations command following this syntax:

Request sample
$ aws directconnect describe-locations \
    --profile YOUR_PROFILE \
    --endpoint https://directlink.eu-west-2.outscale.com

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

The describe-locations command returns the following elements:

  • locations: Information about one or more locations. This element contains the following information for each location:

    • locationName: The name of the location, indicating its physical site.

    • locationCode: The code of the location, needed to request a connection.

Result sample
{
    "locations": [
        {
            "locationName": "Telehouse 3 D02",
            "locationCode": "PAR1"
        }
    ]
}

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