View a markdown version of this page

Utilisez la commande Direct Connect INTERFACE DE LIGNE DE COMMANDE (CLI) - AWS Direct Connect
Étape 1 : Créer une connexionÉtape 2 : Téléchargez le LOA-CFAÉtape 3 : Créer une interface virtuelle et récupérer la configuration du routeur

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisez la commande Direct Connect INTERFACE DE LIGNE DE COMMANDE (CLI)

Vous pouvez utiliser le AWS CLI pour créer et utiliser des Direct Connect ressources.

L'exemple suivant utilise les AWS CLI commandes pour créer une Direct Connect connexion. Vous pouvez également télécharger la lettre d'autorisation et l'attribution des installations de connexion (LOA-CFA) ou configurer une interface virtuelle privée ou publique.

Avant de commencer, veillez à avoir installer et configurer l' AWS CLI. Pour plus d’informations, consultez le Guide de l’utilisateur AWS Command Line Interface.

Étape 1 : Créer une connexion

La première étape consiste à envoyer une demande de connexion. Assurez-vous de connaître la vitesse du port dont vous avez besoin et son Direct Connect emplacement. Pour de plus amples informations, veuillez consulter Connexions dédiées et hébergées.

Pour créer une demande de connexion

  1. Décrivez les Direct Connect emplacements de votre région actuelle. Dans le résultat renvoyé, notez le code de l'emplacement pour l'emplacement dans lequel vous souhaitez établir la connexion.

    aws directconnect describe-locations
    {
    "locations": [
        {
            "locationName": "City 1, United States",
            "locationCode": "Example Location 1"
        },
        {
            "locationName": "City 2, United States",
            "locationCode": "Example location"
        }
    ]
}

  2. Créez la connexion et indiquez le nom, la vitesse du port et le code de l'emplacement. Dans le résultat renvoyé, notez l'ID de connexion. Vous avez besoin de l'identifiant pour l'obtenir LOA-CFA à l'étape suivante.

    aws directconnect create-connection --location Example location --bandwidth 1Gbps --connection-name "Connection to AWS"
    {
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-EXAMPLE",
    "connectionState": "requested",
    "bandwidth": "1Gbps",
    "location": "Example location",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

Étape 2 : Téléchargez le LOA-CFA

Après avoir demandé une connexion, vous pouvez l'obtenir à l' LOA-CFA aide de la describe-loa commande. Le résultat est codé en base64. Vous devez extraire le contenu LOA pertinent, le décoder et créer un fichier PDF.

Pour obtenir le logiciel LOA-CFA sous Linux ou macOS

Dans cet exemple, la dernière partie de la commande décode le contenu à l'aide de l'utilitaire en base64 et envoie le résultat vers un fichier PDF.

aws directconnect describe-loa --connection-id dxcon-fg31dyv6 --output text --query loaContent|base64 --decode > myLoaCfa.pdf
Pour obtenir l' LOA-CFA utilisation de Windows

Dans cet exemple, le résultat est extrait dans un fichier appelé myLoaCfa.base64. La deuxième commande utilise l’utilitaire certutil pour décoder le fichier et envoyer le résultat vers un fichier PDF.

aws directconneawsct describe-loa --connection-id dxcon-fg31dyv6 --output text --query loaContent > myLoaCfa.base64
certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Après avoir téléchargé le LOA-CFA, envoyez-le à votre fournisseur de réseau ou à votre fournisseur de colocation.

Étape 3 : Créer une interface virtuelle et récupérer la configuration du routeur

Après avoir commandé une Direct Connect connexion, vous devez créer une interface virtuelle pour commencer à l'utiliser. Vous pouvez créer une interface virtuelle privée pour vous connecter à votre VPC. Vous pouvez également créer une interface virtuelle publique pour vous connecter à AWS des services qui ne figurent pas dans un VPC. Vous pouvez créer une interface virtuelle qui prend en charge le trafic IPv4 ou IPv6.

Avant de commencer, veillez à prendre connaissance des conditions préalables dans Conditions préalables pour les interfaces virtuelles.

Lorsque vous créez une interface virtuelle à l'aide de AWS CLI, la sortie inclut des informations de configuration génériques du routeur. Pour créer une configuration de routeur spécifique à votre appareil, utilisez la Direct Connect console. Pour de plus amples informations, veuillez consulter Télécharger le fichier de configuration du routeur.

Pour créer une interface virtuelle privée

  1. Récupérez l'ID de la passerelle réseau privé virtuel (vgw-xxxxxxxx) attachée à votre VPC. Vous avez besoin de l'ID pour créer l'interface virtuelle dans l'étape suivante.

    aws ec2 describe-vpn-gateways
    {
    "VpnGateways": [
        {
            "State": "available", 
            "Tags": [
                {
                    "Value": "DX_VGW", 
                    "Key": "Name"
                }
            ], 
            "Type": "ipsec.1", 
            "VpnGatewayId": "vgw-ebaa27db", 
            "VpcAttachments": [
                {
                    "State": "attached", 
                    "VpcId": "vpc-24f33d4d"
                }
            ]
        }
    ]
}

  2. Créez une interface virtuelle privée. Vous devez spécifier un nom, un ID VLAN et un numéro d'ASN (Autonomous System Number) BGP (Border Gateway Protocol).

    Pour le trafic IPv4, vous avez besoin d'adresses IPv4 privées pour chaque fin de la session d'appairage BGP. Vous pouvez spécifier vos propres adresses IPv4 ou laisser Amazon les générer pour vous. Dans l'exemple suivant, les adresses IPv4 sont générées pour vous.

    aws directconnect create-private-virtual-interface --connection-id dxcon-fg31dyv6 --new-private-virtual-interface virtualInterfaceName=PrivateVirtualInterface,vlan=101,asn=65000,virtualGatewayId=vgw-ebaa27db,addressFamily=ipv4
    {
    "virtualInterfaceState": "pending",
    "asn": 65000,
    "vlan": 101,
    "customerAddress": "192.168.1.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "addressFamily": "ipv4", 
    "virtualGatewayId": "vgw-ebaa27db",
    "virtualInterfaceId": "dxvif-ffhhk74f",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [],
    "location": "Example location",
    "bgpPeers": [
        {
            "bgpStatus": "down", 
            "customerAddress": "192.168.1.2/30", 
            "addressFamily": "ipv4", 
            "authKey": "asdf34example", 
            "bgpPeerState": "pending", 
            "amazonAddress": "192.168.1.1/30", 
            "asn": 65000
        }
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-ffhhk74f\">\n  <vlan>101</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
    "amazonAddress": "192.168.1.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "PrivateVirtualInterface"
}

    Pour créer une interface virtuelle privée prenant en charge le trafic IPv6, utilisez la même commande ci-dessus et spécifiez ipv6 pour le paramètre addressFamily. Vous ne pouvez pas spécifier vos propres adresses IPv6 pour la session d'appairage BGP ; Amazon vous attribue des adresses IPv6.

  3. Pour afficher les informations de configuration du routeur au format XML, décrivez l'interface virtuelle que vous avez créée. Utilisez le paramètre --query pour extraire les informations customerRouterConfig et le paramètre --output pour organiser le texte en lignes délimitées par des tabulations.

    aws directconnect describe-virtual-interfaces --virtual-interface-id dxvif-ffhhk74f --query virtualInterfaces[*].customerRouterConfig --output text
    <?xml version="1.0" encoding="UTF-8"?>
<logical_connection id="dxvif-ffhhk74f">
  <vlan>101</vlan>
  <customer_address>192.168.1.2/30</customer_address>
  <amazon_address>192.168.1.1/30</amazon_address>
  <bgp_asn>65000</bgp_asn>
  <bgp_auth_key>asdf34example</bgp_auth_key>
  <amazon_bgp_asn>7224</amazon_bgp_asn>
  <connection_type>private</connection_type>
</logical_connection>
Pour créer une interface virtuelle publique

  1. Pour créer une interface virtuelle publique, vous devez spécifier un nom, un ID VLAN et un numéro d'ASN (Autonomous System Number) BGP (Border Gateway Protocol).

    Pour le trafic IPv4, vous devez également spécifier des adresses IPv4 publiques pour chaque fin de la session d'appairage BGP et des routes IPv4 publiques que vous publiez sur BGP. L'exemple suivant crée une interface virtuelle publique pour le trafic IPv4.

    aws directconnect create-public-virtual-interface --connection-id dxcon-fg31dyv6 --new-public-virtual-interface virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,addressFamily=ipv4,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}]
    {
    "virtualInterfaceState": "verifying",
    "asn": 65000,
    "vlan": 2000,
    "customerAddress": "203.0.113.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "addressFamily": "ipv4",
    "virtualGatewayId": "",
    "virtualInterfaceId": "dxvif-fgh0hcrk",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [
        {
            "cidr": "203.0.113.0/30"
        },
        {
            "cidr": "203.0.113.4/30"
        }
    ],
    "location": "Example location",
    "bgpPeers": [
        {
            "bgpStatus": "down", 
            "customerAddress": "203.0.113.2/30", 
            "addressFamily": "ipv4", 
            "authKey": "asdf34example", 
            "bgpPeerState": "verifying", 
            "amazonAddress": "203.0.113.1/30", 
            "asn": 65000
        }
    ],
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgh0hcrk\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
    "amazonAddress": "203.0.113.1/30",
    "virtualInterfaceType": "public",
    "virtualInterfaceName": "PublicVirtualInterface"
}

    Pour créer une interface virtuelle publique prenant en charge le trafic IPv6, vous pouvez spécifier les routes IPv6 que vous publierez sur BGP. Vous ne pouvez pas spécifier d'adresses IPv6 pour la session d'appairage ; Amazon vous les attribue. L'exemple suivant crée une interface virtuelle publique pour le trafic IPv6.

    aws directconnect create-public-virtual-interface --connection-id dxcon-fg31dyv6 --new-public-virtual-interface virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,addressFamily=ipv6,routeFilterPrefixes=[{cidr=2001:db8:64ce:ba00::/64},{cidr=2001:db8:64ce:ba01::/64}]

  2. Pour afficher les informations de configuration du routeur au format XML, décrivez l'interface virtuelle que vous avez créée. Utilisez le paramètre --query pour extraire les informations customerRouterConfig et le paramètre --output pour organiser le texte en lignes délimitées par des tabulations.

    aws directconnect describe-virtual-interfaces --virtual-interface-id dxvif-fgh0hcrk --query virtualInterfaces[*].customerRouterConfig --output text

    <?xml version="1.0" encoding="UTF-8"?>
<logical_connection id="dxvif-fgh0hcrk">
  <vlan>2000</vlan>
  <customer_address>203.0.113.2/30</customer_address>
  <amazon_address>203.0.113.1/30</amazon_address>
  <bgp_asn>65000</bgp_asn>
  <bgp_auth_key>asdf34example</bgp_auth_key>
  <amazon_bgp_asn>7224</amazon_bgp_asn>
  <connection_type>public</connection_type>
</logical_connection>