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

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

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.