Obtenir des informations sur vos DirectLink interfaces

Vous pouvez obtenir des informations sur une ou plusieurs de vos DirectLink interfaces.

Vous pouvez utiliser le paramètre connection-id pour décrire uniquement des virtual interfaces associées à une connexion DirectLink spécifique, ou le paramètre virtual-interface-id pour décrire uniquement une virtual interface spécifique.

Obtenir des informations sur vos DirectLink interfaces avec Cockpit v2

Voir le dashboard DirectLink Interfaces.

Obtenir des informations sur vos DirectLink interfaces avec OSC CLI

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

The ReadDirectLinkInterfaces command lists one or more of your DirectLink interfaces.

Request sample
$ osc-cli api ReadDirectLinkInterfaces --profile "default" \
    --Filters '{
        "DirectLinkInterfaceIds": ["dxvif-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.

  • 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 ReadDirectLinkInterfaces command returns the following elements:

  • DirectLinkInterfaces: Information about one or more DirectLink interfaces.

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

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "DirectLinkInterfaces": [
    {
      "Vlan": 101,
      "OutscalePrivateIp": "172.16.0.4/30",
      "DirectLinkInterfaceId": "dxvif-12345678",
      "BgpAsn": 65000,
      "AccountId": "123456789012",
      "ClientPrivateIp": "172.16.0.5/30",
      "VirtualGatewayId": "vgw-12345678",
      "DirectLinkInterfaceName": "MyDirectLinkInterface",
      "DirectLinkId": "dxcon-12345678",
      "Mtu": 1500,
      "State": "available",
      "InterfaceType": "private",
      "Location": "PAR1"
    }
  ]
}

Obtenir des informations sur vos virtual interfaces privées avec AWS CLI

Pour obtenir des informations sur une ou plusieurs de vos virtual interfaces privées, utilisez la commande describe-virtual-interfaces en suivant cette syntaxe :

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

Cette commande contient les attributs suivants 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 d’une connexion.

  • (optionnel) virtual-interface-id : L’ID d’une virtual interface privée.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-virtual-interfaces renvoie les éléments suivants :

  • virtualInterfaces : Informations sur une ou plusieurs virtual interfaces privées. Cet élément contient les informations suivantes :

    • virtualInterfaceState : L’état de la virtual interface. Pour en savoir plus, voir À propos de DirectLink.

    • asn : L’autonomous system number (ASN) pour la configuration Border Gateway Protocol (BGP) du côté client de la virtual interface.

    • vlan : Le numéro de VLAN associé à la virtual interface.

    • customerAddress : L’IP côté client de la virtual interface.

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

    • connectionId : L’ID de la connexion.

    • virtualGatewayId : La virtual private gateway cible.

    • authKey : La clé d’authentification BGP.

    • location : Le data center où se trouve la virtual interface.

    • amazonAddress : L’IP côté OUTSCALE de la virtual interface.

    • virtualInterfaceType : Le type de virtual interface (toujours private).

    • virtualInterfaceName : Le nom de la virtual interface.

Exemple de résultat
{
    "virtualInterfaces": [
        {
            "virtualInterfaceState": "available",
            "asn": 65000,
            "vlan": 101,
            "customerAddress": "192.100.1.0/30",
            "ownerAccount": "12345678",
            "connectionId": "dxcon-aa00bb11cc22",
            "virtualGatewayId": "vgw-dd33ee44ff55",
            "virtualInterfaceId": "dxvif-gg66hh77ii88",
            "authKey": "asdf65sample",
            "location": "PAR1",
            "amazonAddress": "192.100.1.1/30",
            "virtualInterfaceType": "private",
            "virtualInterfaceName": "PrivateVirtualInterface"
        }
    ]
}

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