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.

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

    • DirectLinkInterfaceIds: (optional) The IDs of the DirectLink interfaces.

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

    • AccountId: The account ID of the owner of the DirectLink interface.

    • BgpAsn: The BGP (Border Gateway Protocol) ASN (Autonomous System Number) on the customer’s side of the DirectLink interface.

    • BgpKey: The BGP authentication key.

    • ClientPrivateIp: The IP on the customer’s side of the DirectLink interface.

    • DirectLinkId: The ID of the DirectLink.

    • DirectLinkInterfaceId: The ID of the DirectLink interface.

    • DirectLinkInterfaceName: The name of the DirectLink interface.

    • InterfaceType: The type of the DirectLink interface (always private).

    • Location: The datacenter where the DirectLink interface is located.

    • Mtu: The maximum transmission unit (MTU) of the DirectLink interface, in bytes (always 1500).

    • OutscalePrivateIp: The IP on the OUTSCALE side of the DirectLink interface.

    • State: The state of the DirectLink interface (pending | available | deleting | deleted | confirming | rejected | expired).

    • VirtualGatewayId: The ID of the target virtual gateway.

    • Vlan: The VLAN number associated with the DirectLink interface.

  • 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"
  },
  "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 DirectLink interfaces avec oapi-cli

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

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

Request sample
$ oapi-cli --profile "default" ReadDirectLinkInterfaces \
    --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.

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

    • DirectLinkInterfaceIds: (optional) The IDs of the DirectLink interfaces.

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

    • AccountId: The account ID of the owner of the DirectLink interface.

    • BgpAsn: The BGP (Border Gateway Protocol) ASN (Autonomous System Number) on the customer’s side of the DirectLink interface.

    • BgpKey: The BGP authentication key.

    • ClientPrivateIp: The IP on the customer’s side of the DirectLink interface.

    • DirectLinkId: The ID of the DirectLink.

    • DirectLinkInterfaceId: The ID of the DirectLink interface.

    • DirectLinkInterfaceName: The name of the DirectLink interface.

    • InterfaceType: The type of the DirectLink interface (always private).

    • Location: The datacenter where the DirectLink interface is located.

    • Mtu: The maximum transmission unit (MTU) of the DirectLink interface, in bytes (always 1500).

    • OutscalePrivateIp: The IP on the OUTSCALE side of the DirectLink interface.

    • State: The state of the DirectLink interface (pending | available | deleting | deleted | confirming | rejected | expired).

    • VirtualGatewayId: The ID of the target virtual gateway.

    • Vlan: The VLAN number associated with the DirectLink interface.

  • 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"
  },
  "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

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer 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. Pour en savoir plus, voir Installer et configurer AWS CLI.

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