Obtenir des informations sur vos connexions

Vous pouvez obtenir des informations à propos de vos connexions situées dans la Région correspondant à votre compte.

Obtenir des informations sur vos connexions avec Cockpit v2

Voir le dashboard DirectLink.

Obtenir des informations sur vos connexions avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The ReadDirectLinks command lists all DirectLinks in the Region.

Request sample
$ osc-cli api ReadDirectLinks --profile "default" \
    --Filters '{
        "DirectLinkIds": ["dxcon-12345678"]
      }'

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

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

  • Filters: (optional) One or more filters.

    • DirectLinkIds: (optional) The IDs of the DirectLinks.

  • 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). By default, 100.

The ReadDirectLinks command returns the following elements:

  • DirectLinks: Information about one or more DirectLinks.

    • 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.

  • 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"
  },
  "DirectLinks": [
    {
      "AccountId": "123456789012",
      "Bandwidth": "1Gbps",
      "DirectLinkId": "dxcon-12345678",
      "DirectLinkName": "Connection to Outscale",
      "Location": "PAR1",
      "RegionName": "eu-west-2",
      "State": "available"
    }
  ]
}

Obtenir des informations sur vos connexions avec oapi-cli

À ce jour, cette section est disponible en anglais uniquement.

The ReadDirectLinks command lists all DirectLinks in the Region.

Request sample
$ oapi-cli --profile "default" ReadDirectLinks \
    --Filters '{
        "DirectLinkIds": ["dxcon-12345678"]
      }'

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

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

  • Filters: (optional) One or more filters.

    • DirectLinkIds: (optional) The IDs of the DirectLinks.

  • 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). By default, 100.

The ReadDirectLinks command returns the following elements:

  • DirectLinks: Information about one or more DirectLinks.

    • 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.

  • 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"
  },
  "DirectLinks": [
    {
      "AccountId": "123456789012",
      "Bandwidth": "1Gbps",
      "DirectLinkId": "dxcon-12345678",
      "DirectLinkName": "Connection to Outscale",
      "Location": "PAR1",
      "RegionName": "eu-west-2",
      "State": "available"
    }
  ]
}

Obtenir des informations sur vos connexions avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour obtenir des informations à propos de vos connexions, utilisez la commande describe-connections en suivant cette syntaxe :

Exemple de requête
$ aws directconnect describe-connections \
    --profile YOUR_PROFILE \
    --connection-id dxcon-12345678 \
    --endpoint https://directlink.eu-west-2.outscale.com

Cette commande contient les options suivantes que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • (optionnel) connection-id : L’ID de la connexion.

    Si vous ne spécifiez pas d’ID de connexion, vous obtenez des informations à propos de toutes vos connexions dans la Région correspondant à votre compte.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande describe-connections renvoie les éléments suivants :

  • connections : Informations à propos d’une ou plusieurs connexions. Cet élément contient les informations suivantes :

    • ownerAccount : L’ID de compte du propriétaire de la connexion.

    • connectionID : L’ID de la connexion.

    • connectionState : L’état de la connexion. Pour en savoir plus, voir À propos de DirectLink.

    • bandwidth : La bande passante de la connexion.

    • location : Le site de la connexion.

    • connectionName : Le nom de la connexion.

    • region : La Région où se trouve la connexion.

Exemple de résultat
{
    "connections": [
        {
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-12345678",
            "connectionState": "requested",
            "bandwidth": "1Gbps",
            "location": "PAR1",
            "connectionName": "Connection to Outscale",
            "region": "eu-west-2"
        }
    ]
}

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.

Exporter en PDF