Exemples d’utilisation de l’AWS CLI avec Direct Connect - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Direct Connect

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Direct Connect.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser accept-direct-connect-gateway-association-proposal.

AWS CLI

Pour accepter une proposition d’association de passerelle

L’exemple accept-direct-connect-gateway-association-proposal suivant accepte la proposition spécifiée.

aws directconnect  accept-direct-connect-gateway-association-proposal \
    --direct-connect-gateway-id 11460968-4ac1-4fd3-bdb2-00599EXAMPLE \
    --proposal-id cb7f41cb-8128-43a5-93b1-dcaedEXAMPLE \
    --associated-gateway-owner-account 111122223333

{
    "directConnectGatewayAssociation": {
        "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
        "directConnectGatewayOwnerAccount": "111122223333",
        "associationState": "associating",
        "associatedGateway": {
            "id": "tgw-02f776b1a7EXAMPLE",
            "type": "transitGateway",
            "ownerAccount": "111122223333",
            "region": "us-east-1"
        },
        "associationId": "6441f8bf-5917-4279-ade1-9708bEXAMPLE",
        "allowedPrefixesToDirectConnectGateway": [
            {
                "cidr": "192.168.1.0/30"
            }
        ]
    }
}

Pour plus d’informations, consultez Acceptation ou rejet d’une proposition d’association de la passerelle de transit dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser allocate-connection-on-interconnect.

AWS CLI

Pour créer une connexion hébergée sur une interconnexion

La commande allocate-connection-on-interconnect suivante crée une connexion hébergée sur une interconnexion :

aws directconnect allocate-connection-on-interconnect --bandwidth 500Mbps --connection-name mydcinterconnect --owner-account 123456789012 --interconnect-id dxcon-fgktov66 --vlan 101

Sortie :

{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}

L’exemple de code suivant montre comment utiliser allocate-hosted-connection.

AWS CLI

Pour créer une connexion hébergée sur une interconnexion

L’exemple allocate-hosted-connection suivant crée une connexion hébergée sur l’interconnexion spécifiée.

aws directconnect allocate-hosted-connection \
    --bandwidth 500Mbps \
    --connection-name mydcinterconnect \
    --owner-account 123456789012
    -connection-id dxcon-fgktov66
    -vlan 101

Sortie :

{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}

  • Pour plus de détails sur l’API, consultez AllocateHostedConnection dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser allocate-private-virtual-interface.

AWS CLI

Pour provisionner une interface virtuelle privée

La commande allocate-private-virtual-interface suivante provisionne une interface virtuelle privée devant être détenue par un autre client :

aws directconnect allocate-private-virtual-interface --connection-id dxcon-ffjrkx17 --owner-account 123456789012 --new-private-virtual-interface-allocation virtualInterfaceName=PrivateVirtualInterface,vlan=1000,asn=65000,authKey=asdf34example,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30

Sortie :

{
    "virtualInterfaceState": "confirming",
    "asn": 65000,
    "vlan": 1000,
    "customerAddress": "192.168.1.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualInterfaceId": "dxvif-fgy8orxu",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n  <logical_connection id=\"dxvif-fgy8orxu\">\n  <vlan>1000</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"
}

L’exemple de code suivant montre comment utiliser allocate-public-virtual-interface.

AWS CLI

Pour provisionner une interface virtuelle publique

La commande allocate-public-virtual-interface suivante provisionne une interface virtuelle publique devant être détenue par un autre client :

aws directconnect allocate-public-virtual-interface --connection-id dxcon-ffjrkx17 --owner-account 123456789012 --new-public-virtual-interface-allocation virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,authKey=asdf34example,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}]

Sortie :

{
    "virtualInterfaceState": "confirming",
    "asn": 65000,
    "vlan": 2000,
    "customerAddress": "203.0.113.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualInterfaceId": "dxvif-fg9xo9vp",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [
        {
            "cidr": "203.0.113.0/30"
        },
        {
            "cidr": "203.0.113.4/30"
        }
    ],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg9xo9vp\">\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"
}

L’exemple de code suivant montre comment utiliser allocate-transit-virtual-interface.

AWS CLI

Pour provisionner une interface virtuelle de transit devant être détenue par le compte AWS spécifié

L’exemple allocate-transit-virtual-interface suivant provisionne une interface virtuelle de transit pour le compte spécifié.

aws directconnect allocate-transit-virtual-interface \
    --connection-id dxlag-fEXAMPLE \
    --owner-account 123456789012 \
    --new-transit-virtual-interface-allocation "virtualInterfaceName=Example Transit Virtual Interface,vlan=126,asn=65110,mtu=1500,authKey=0xzxgA9YoW9h58u8SEXAMPLE,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30,addressFamily=ipv4,tags=[{key=Tag,value=Example}]"

Sortie :

{
    "virtualInterface": {
        "ownerAccount": "123456789012",
        "virtualInterfaceId": "dxvif-fEXAMPLE",
        "location": "loc1",
        "connectionId": "dxlag-fEXAMPLE",
        "virtualInterfaceType": "transit",
        "virtualInterfaceName": "Example Transit Virtual Interface",
        "vlan": 126,
        "asn": 65110,
        "amazonSideAsn": 7224,
        "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
        "amazonAddress": "192.168.1.1/30",
        "customerAddress": "192.168.1.2/30",
        "addressFamily": "ipv4",
        "virtualInterfaceState": "confirming",
        "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fEXAMPLE\">\n  <vlan>126</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65110</bgp_asn>\n  <bgp_auth_key>0xzxgA9YoW9h58u8SEXAMPLE</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>transit</connection_type>\n</logical_connection>\n",
        "mtu": 1500,
        "jumboFrameCapable": true,
        "virtualGatewayId": "",
        "directConnectGatewayId": "",
        "routeFilterPrefixes": [],
        "bgpPeers": [
            {
                "bgpPeerId": "dxpeer-fEXAMPLE",
                "asn": 65110,
                "authKey": "0xzxgA9YoW9h58u8EXAMPLE",
                "addressFamily": "ipv4",
                "amazonAddress": "192.168.1.1/30",
                "customerAddress": "192.168.1.2/30",
                "bgpPeerState": "pending",
                "bgpStatus": "down",
                "awsDeviceV2": "loc1-26wz6vEXAMPLE"
            }
        ],
        "region": "sa-east-1",
        "awsDeviceV2": "loc1-26wz6vEXAMPLE",
        "tags": [
            {
                "key": "Tag",
                "value": "Example"
            }
        ]
    }
}

Pour plus d’informations, consultez Création d’une interface de transit virtuelle hébergée dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser associate-connection-with-lag.

AWS CLI

Pour associer une connexion à un LAG

L’exemple suivant associe la connexion spécifiée au LAG spécifié.

Commande :

aws directconnect associate-connection-with-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm

Sortie :

{
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "lagId": "dxlag-fhccu14t",
  "connectionState": "requested",
  "bandwidth": "1Gbps",
  "location": "EqDC2",
  "connectionName": "Con2ForLag",
  "region": "us-east-1"
}

L’exemple de code suivant montre comment utiliser associate-hosted-connection.

AWS CLI

Pour associer une connexion hébergée à un LAG

L’exemple suivant associe la connexion hébergée spécifiée au LAG spécifié.

Commande :

aws directconnect associate-hosted-connection --parent-connection-id dxlag-fhccu14t --connection-id dxcon-fg9607vm

Sortie :

{
  "partnerName": "TIVIT",
  "vlan": 101,
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "lagId": "dxlag-fhccu14t",
  "connectionState": "ordering",
  "bandwidth": "500Mbps",
  "location": "TIVIT",
  "connectionName": "mydcinterconnect",
  "region": "sa-east-1"
}

L’exemple de code suivant montre comment utiliser associate-virtual-interface.

AWS CLI

Pour associer une interface virtuelle à une connexion

L’exemple suivant associe l’interface virtuelle spécifiée au LAG spécifié. Pour associer l’interface virtuelle à une connexion, vous pouvez également spécifier l’ID d’une connexion AWS Direct Connect pour --connection-id (par exemple, dxcon-ffnikghc).

Commande :

aws directconnect associate-virtual-interface --connection-id dxlag-ffjhj9lx --virtual-interface-id dxvif-fgputw0j

Sortie :

{
  "virtualInterfaceState": "pending",
  "asn": 65000,
  "vlan": 123,
  "customerAddress": "169.254.255.2/30",
  "ownerAccount": "123456789012",
  "connectionId": "dxlag-ffjhj9lx",
  "addressFamily": "ipv4",
  "virtualGatewayId": "vgw-38e90b51",
  "virtualInterfaceId": "dxvif-fgputw0j",
  "authKey": "0x123pK5_VBqv.UQ3kJ4123_",
  "routeFilterPrefixes": [],
  "location": "CSVA1",
  "bgpPeers": [
      {
          "bgpStatus": "down",
          "customerAddress": "169.254.255.2/30",
          "addressFamily": "ipv4",
          "authKey": "0x123pK5_VBqv.UQ3kJ4123_",
          "bgpPeerState": "deleting",
          "amazonAddress": "169.254.255.1/30",
          "asn": 65000
      },
      {
          "bgpStatus": "down",
          "customerAddress": "169.254.255.2/30",
          "addressFamily": "ipv4",
          "authKey": "0x123pK5_VBqv.UQ3kJ4123_",
          "bgpPeerState": "pending",
          "amazonAddress": "169.254.255.1/30",
          "asn": 65000
      }
  ],
  "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgputw0j\">\n  <vlan>123</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0x123pK5_VBqv.UQ3kJ4123_</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
  "amazonAddress": "169.254.255.1/30",
  "virtualInterfaceType": "private",
  "virtualInterfaceName": "VIF1A"
}

L’exemple de code suivant montre comment utiliser confirm-connection.

AWS CLI

Pour confirmer la création d’une connexion hébergée sur une interconnexion

La commande confirm-connection suivante confirme la création d’une connexion hébergée sur une interconnexion :

aws directconnect confirm-connection --connection-id dxcon-fg2wi7hy

Sortie :

{
    "connectionState": "pending"
}

  • Pour plus de détails sur l’API, consultez ConfirmConnection dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser confirm-private-virtual-interface.

AWS CLI

Pour accepter la propriété d’une interface virtuelle privée

La commande confirm-private-virtual-interface suivante accepte la propriété d’une interface virtuelle privée créée par un autre client :

aws directconnect confirm-private-virtual-interface --virtual-interface-id dxvif-fgy8orxu --virtual-gateway-id vgw-e4a47df9

Sortie :

{
    "virtualInterfaceState": "pending"
}

L’exemple de code suivant montre comment utiliser confirm-public-virtual-interface.

AWS CLI

Pour accepter la propriété d’une interface virtuelle publique

La commande confirm-public-virtual-interface suivante accepte la propriété d’une interface virtuelle publique créée par un autre client :

aws directconnect confirm-public-virtual-interface --virtual-interface-id dxvif-fg9xo9vp

Sortie :

{
    "virtualInterfaceState": "verifying"
}

L’exemple de code suivant montre comment utiliser confirm-transit-virtual-interface.

AWS CLI

Pour accepter la propriété d’une interface virtuelle de transit

La commande confirm-transit-virtual-interface suivante accepte la propriété d’une interface virtuelle de transit créée par un autre client.

aws directconnect confirm-transit-virtual-interface \
    --virtual-interface-id dxvif-fEXAMPLE \
    --direct-connect-gateway-id 4112ccf9-25e9-4111-8237-b6c5dEXAMPLE

Sortie :

{
    "virtualInterfaceState": "pending"
}

Pour plus d’informations, consultez Acceptation d’une interface virtuelle hébergée dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser create-bgp-peer.

AWS CLI

Pour créer une session d’appairage BGP IPv6

L’exemple suivant crée une session d’appairage BGP IPv6 sur une interface virtuelle privée dxvif-fg1vuj3d. Les adresses IPv6 appairées sont automatiquement allouées par Amazon.

Commande :

aws directconnect create-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --new-bgp-peer asn=64600,addressFamily=ipv6

Sortie :

{
  "virtualInterface": {
      "virtualInterfaceState": "available",
      "asn": 65000,
      "vlan": 125,
      "customerAddress": "169.254.255.2/30",
      "ownerAccount": "123456789012",
      "connectionId": "dxcon-fguhmqlc",
      "addressFamily": "ipv4",
      "virtualGatewayId": "vgw-f9eb0c90",
      "virtualInterfaceId": "dxvif-fg1vuj3d",
      "authKey": "0xC_ukbCerl6EYA0example",
      "routeFilterPrefixes": [],
      "location": "EqDC2",
      "bgpPeers": [
          {
              "bgpStatus": "down",
              "customerAddress": "169.254.255.2/30",
              "addressFamily": "ipv4",
              "authKey": "0xC_ukbCerl6EYA0uexample",
              "bgpPeerState": "available",
              "amazonAddress": "169.254.255.1/30",
              "asn": 65000
          },
          {
              "bgpStatus": "down",
              "customerAddress": "2001:db8:1100:2f0:0:1:9cb4:4216/125",
              "addressFamily": "ipv6",
              "authKey": "0xS27kAIU_VHPjjAexample",
              "bgpPeerState": "pending",
              "amazonAddress": "2001:db8:1100:2f0:0:1:9cb4:4211/125",
              "asn": 64600
          }
      ],
      "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg1vuj3d\">\n  <vlan>125</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0xC_ukbCerl6EYA0uexample</bgp_auth_key>\n  <ipv6_customer_address>2001:db8:1100:2f0:0:1:9cb4:4216/125</ipv6_customer_address>\n  <ipv6_amazon_address>2001:db8:1100:2f0:0:1:9cb4:4211/125</ipv6_amazon_address>\n  <ipv6_bgp_asn>64600</ipv6_bgp_asn>\n  <ipv6_bgp_auth_key>0xS27kAIU_VHPjjAexample</ipv6_bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
      "amazonAddress": "169.254.255.1/30",
      "virtualInterfaceType": "private",
      "virtualInterfaceName": "Test"
  }
}

  • Pour plus de détails sur l’API, consultez CreateBgpPeer dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-connection.

AWS CLI

Pour créer une connexion entre votre réseau et un emplacement AWS Direct Connect

La commande create-connection suivante crée une connexion entre votre réseau et un emplacement AWS Direct Connect :

aws directconnect create-connection --location TIVIT --bandwidth 1Gbps --connection-name "Connection to AWS"

Sortie :

{
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "connectionState": "requested",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

  • Pour plus de détails sur l’API, consultez CreateConnection dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-direct-connect-gateway-association-proposal.

AWS CLI

Pour créer une proposition visant à associer la passerelle de transit spécifiée à la passerelle Direct Connect spécifiée

L’exemple create-direct-connect-gateway-association-proposal suivant crée une proposition qui associe la passerelle de transit spécifiée à la passerelle Direct Connect spécifiée.

aws directconnect create-direct-connect-gateway-association-proposal \
    --direct-connect-gateway-id 11460968-4ac1-4fd3-bdb2-00599EXAMPLE \
    --direct-connect-gateway-owner-account 111122223333 \
    --gateway-id tgw-02f776b1a7EXAMPLE \
    --add-allowed-prefixes-to-direct-connect-gateway cidr=192.168.1.0/30

Sortie :

{
    "directConnectGatewayAssociationProposal": {
        "proposalId": "cb7f41cb-8128-43a5-93b1-dcaedEXAMPLE",
        "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
        "directConnectGatewayOwnerAccount": "111122223333",
        "proposalState": "requested",
        "associatedGateway": {
            "id": "tgw-02f776b1a7EXAMPLE",
            "type": "transitGateway",
            "ownerAccount": "111122223333",
            "region": "us-east-1"
        },
        "requestedAllowedPrefixesToDirectConnectGateway": [
            {
                "cidr": "192.168.1.0/30"
            }
        ]
    }
}

Pour plus d’informations, consultez Création d’une proposition d’association de la passerelle de transit dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser create-direct-connect-gateway-association.

AWS CLI

Pour associer une passerelle privée virtuelle à une passerelle Direct Connect

L’exemple suivant associe une passerelle privée virtuelle vgw-6efe725e à une passerelle Direct Connect 5f294f92-bafb-4011-916d-9b0bexample. Vous devez exécuter la commande dans la région dans laquelle se trouve la passerelle privée virtuelle.

Commande :

aws directconnect create-direct-connect-gateway-association --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample --virtual-gateway-id vgw-6efe725e

Sortie :

{
  "directConnectGatewayAssociation": {
      "associationState": "associating",
      "virtualGatewayOwnerAccount": "123456789012",
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
      "virtualGatewayId": "vgw-6efe725e",
      "virtualGatewayRegion": "us-east-2"
  }
}

L’exemple de code suivant montre comment utiliser create-direct-connect-gateway.

AWS CLI

Pour créer une passerelle Direct Connect

L’exemple suivant crée une passerelle Direct Connect nommée DxGateway1.

Commande :

aws directconnect create-direct-connect-gateway --direct-connect-gateway-name "DxGateway1"

Sortie :

{
  "directConnectGateway": {
      "amazonSideAsn": 64512,
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample",
      "ownerAccount": "123456789012",
      "directConnectGatewayName": "DxGateway1",
      "directConnectGatewayState": "available"
  }
}

L’exemple de code suivant montre comment utiliser create-interconnect.

AWS CLI

Pour créer une interconnexion entre le réseau d’un partenaire et AWS

La commande create-interconnect suivante crée une interconnexion entre le réseau d’un partenaire AWS Direct Connect et un emplacement AWS Direct Connect spécifique :

aws directconnect create-interconnect --interconnect-name "1G Interconnect to AWS" --bandwidth 1Gbps --location TIVIT

Sortie :

{
    "region": "sa-east-1",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "interconnectName": "1G Interconnect to AWS",
    "interconnectId": "dxcon-fgktov66",
    "interconnectState": "requested"
}

  • Pour plus de détails sur l’API, consultez CreateInterconnect dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-lag.

AWS CLI

Pour créer un LAG avec de nouvelles connexions

L’exemple suivant crée un LAG et demande deux nouvelles connexions AWS Direct Connect pour celui-ci avec une bande passante de 1 Gbit/s.

Commande :

aws directconnect create-lag --location CSVA1 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 1GBLag

Sortie :

{
  "awsDevice": "CSVA1-23u8tlpaz8iks",
  "numberOfConnections": 2,
  "lagState": "pending",
  "ownerAccount": "123456789012",
  "lagName": "1GBLag",
  "connections": [
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-ffqr6x5q",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 1 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      },
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fflqyj95",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 2 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      }
  ],
  "lagId": "dxlag-ffjhj9lx",
  "minimumLinks": 0,
  "connectionsBandwidth": "1Gbps",
  "region": "us-east-1",
  "location": "CSVA1"
}

Pour créer un LAG avec une connexion existante

L’exemple suivant crée un LAG à partir d’une connexion existante dans votre compte et demande une deuxième nouvelle connexion pour celui-ci avec la même bande passante et le même emplacement que la connexion existante.

Commande :

aws directconnect create-lag --location EqDC2 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 2ConnLAG --connection-id dxcon-fgk145dr

Sortie :

{
  "awsDevice": "EqDC2-4h6ce2r1bes6",
  "numberOfConnections": 2,
  "lagState": "pending",
  "ownerAccount": "123456789012",
  "lagName": "2ConnLAG",
  "connections": [
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fh6ljcvo",
          "lagId": "dxlag-fhccu14t",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "EqDC2",
          "connectionName": "Requested Connection 1 for Lag dxlag-fhccu14t",
          "region": "us-east-1"
      },
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fgk145dr",
          "lagId": "dxlag-fhccu14t",
          "connectionState": "down",
          "bandwidth": "1Gbps",
          "location": "EqDC2",
          "connectionName": "VAConn1",
          "region": "us-east-1"
      }
  ],
  "lagId": "dxlag-fhccu14t",
  "minimumLinks": 0,
  "connectionsBandwidth": "1Gbps",
  "region": "us-east-1",
  "location": "EqDC2"
}

  • Pour plus de détails sur l’API, consultez CreateLag dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-private-virtual-interface.

AWS CLI

Pour créer une interface virtuelle privée

La commande create-private-virtual-interface suivante crée une interface virtuelle privée :

aws directconnect create-private-virtual-interface --connection-id dxcon-ffjrkx17 --new-private-virtual-interface virtualInterfaceName=PrivateVirtualInterface,vlan=101,asn=65000,authKey=asdf34example,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30,virtualGatewayId=vgw-aba37db6

Sortie :

{
    "virtualInterfaceState": "pending",
    "asn": 65000,
    "vlan": 101,
    "customerAddress": "192.168.1.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualGatewayId": "vgw-aba37db6",
    "virtualInterfaceId": "dxvif-ffhhk74f",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [],
    "location": "TIVIT",
    "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"
}

L’exemple de code suivant montre comment utiliser create-public-virtual-interface.

AWS CLI

Pour créer une interface virtuelle publique

La commande create-public-virtual-interface suivante crée une interface virtuelle publique :

aws directconnect create-public-virtual-interface --connection-id dxcon-ffjrkx17 --new-public-virtual-interface virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,authKey=asdf34example,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}]

Sortie :

{
    "virtualInterfaceState": "verifying",
    "asn": 65000,
    "vlan": 2000,
    "customerAddress": "203.0.113.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualInterfaceId": "dxvif-fgh0hcrk",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [
        {
            "cidr": "203.0.113.0/30"
        },
        {
            "cidr": "203.0.113.4/30"
        }
    ],
    "location": "TIVIT",
    "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"
}

L’exemple de code suivant montre comment utiliser create-transit-virtual-interface.

AWS CLI

Pour créer une interface virtuelle de transit

L’exemple create-transit-virtual-interface suivant crée une interface virtuelle de transit pour la connexion spécifiée.

aws directconnect create-transit-virtual-interface \
    --connection-id dxlag-fEXAMPLE \
    --new-transit-virtual-interface "virtualInterfaceName=Example Transit Virtual Interface,vlan=126,asn=65110,mtu=1500,authKey=0xzxgA9YoW9h58u8SvEXAMPLE,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30,addressFamily=ipv4,directConnectGatewayId=8384da05-13ce-4a91-aada-5a1baEXAMPLE,tags=[{key=Tag,value=Example}]"

Sortie :

{
    "virtualInterface": {
        "ownerAccount": "1111222233333",
        "virtualInterfaceId": "dxvif-fEXAMPLE",
        "location": "loc1",
        "connectionId": "dxlag-fEXAMPLE",
        "virtualInterfaceType": "transit",
        "virtualInterfaceName": "Example Transit Virtual Interface",
        "vlan": 126,
        "asn": 65110,
        "amazonSideAsn": 4200000000,
        "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
        "amazonAddress": "192.168.1.1/30",
        "customerAddress": "192.168.1.2/30",
        "addressFamily": "ipv4",
        "virtualInterfaceState": "pending",
        "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fEXAMPLE\">\n  <vlan>126</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65110</bgp_asn>\n  <bgp_auth_key>0xzxgA9YoW9h58u8SvOmXRTw</bgp_auth_key>\n  <amazon_bgp_asn>4200000000</amazon_bgp_asn>\n  <connection_type>transit</connection_type>\n</logical_connection>\n",
        "mtu": 1500,
        "jumboFrameCapable": true,
        "virtualGatewayId": "",
        "directConnectGatewayId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE",
        "routeFilterPrefixes": [],
        "bgpPeers": [
            {
                "bgpPeerId": "dxpeer-EXAMPLE",
                "asn": 65110,
                "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
                "addressFamily": "ipv4",
                "amazonAddress": "192.168.1.1/30",
                "customerAddress": "192.168.1.2/30",
                "bgpPeerState": "pending",
                "bgpStatus": "down",
                "awsDeviceV2": "loc1-26wz6vEXAMPLE"
            }
        ],
        "region": "sa-east-1",
        "awsDeviceV2": "loc1-26wz6vEXAMPLE",
        "tags": [
            {
                "key": "Tag",
                "value": "Example"
            }
        ]
    }
}

Pour plus d’informations, consultez Création d’une interface de transit virtuelle vers la passerelle Direct Connect dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser delete-bgp-peer.

AWS CLI

Pour supprimer un appairage BGP d’une interface virtuelle

L’exemple suivant supprime l’appairage BGP IPv6 de l’interface virtuelle dxvif-fg1vuj3d.

Commande :

aws directconnect delete-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --asn 64600 --customer-address 2001:db8:1100:2f0:0:1:9cb4:4216/125

Sortie :

{
  "virtualInterface": {
      "virtualInterfaceState": "available",
      "asn": 65000,
      "vlan": 125,
      "customerAddress": "169.254.255.2/30",
      "ownerAccount": "123456789012",
      "connectionId": "dxcon-fguhmqlc",
      "addressFamily": "ipv4",
      "virtualGatewayId": "vgw-f9eb0c90",
      "virtualInterfaceId": "dxvif-fg1vuj3d",
      "authKey": "0xC_ukbCerl6EYA0example",
      "routeFilterPrefixes": [],
      "location": "EqDC2",
      "bgpPeers": [
          {
              "bgpStatus": "down",
              "customerAddress": "169.254.255.2/30",
              "addressFamily": "ipv4",
              "authKey": "0xC_ukbCerl6EYA0uexample",
              "bgpPeerState": "available",
              "amazonAddress": "169.254.255.1/30",
              "asn": 65000
          },
          {
              "bgpStatus": "down",
              "customerAddress": "2001:db8:1100:2f0:0:1:9cb4:4216/125",
              "addressFamily": "ipv6",
              "authKey": "0xS27kAIU_VHPjjAexample",
              "bgpPeerState": "deleting",
              "amazonAddress": "2001:db8:1100:2f0:0:1:9cb4:4211/125",
              "asn": 64600
          }
      ],
      "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg1vuj3d\">\n  <vlan>125</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0xC_ukbCerl6EYA0example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
      "amazonAddress": "169.254.255.1/30",
      "virtualInterfaceType": "private",
      "virtualInterfaceName": "Test"
  }
}

  • Pour plus de détails sur l’API, consultez DeleteBgpPeer dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-connection.

AWS CLI

Pour supprimer une connexion

La commande delete-connection suivante supprime la connexion spécifiée :

aws directconnect delete-connection --connection-id dxcon-fg31dyv6

Sortie :

{
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "connectionState": "deleted",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

  • Pour plus de détails sur l’API, consultez DeleteConnection dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-direct-connect-gateway-association.

AWS CLI

Pour supprimer une association de passerelle Direct Connect

L’exemple delete-direct-connect-gateway-association suivant supprime l’association de passerelle Direct Connect avec la passerelle de transit dotée de l’ID d’association spécifié.

aws directconnect delete-direct-connect-gateway-association --association-id  be85116d-46eb-4b43-a27a-da0c2ad648de

Sortie :

{
    "directConnectGatewayAssociation": {
        "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPlE",
        "directConnectGatewayOwnerAccount": "123456789012",
        "associationState": "disassociating",
        "associatedGateway": {
            "id": "tgw-095b3b0b54EXAMPLE",
            "type": "transitGateway",
            "ownerAccount": "123456789012",
            "region": "us-east-1"
       },
        "associationId": " be85116d-46eb-4b43-a27a-da0c2ad648deEXAMPLE ",
        "allowedPrefixesToDirectConnectGateway": [
            {
                "cidr": "192.0.1.0/28"
            }
        ]
    }
}

Pour plus d’informations, consultez Association et dissociation de passerelles de transit dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser delete-direct-connect-gateway.

AWS CLI

Pour supprimer une passerelle Direct Connect

L’exemple suivant supprime la passerelle Direct Connect 5f294f92-bafb-4011-916d-9b0bexample.

Commande :

aws directconnect delete-direct-connect-gateway --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample

Sortie :

{
  "directConnectGateway": {
      "amazonSideAsn": 64512,
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
      "ownerAccount": "123456789012",
      "directConnectGatewayName": "DxGateway1",
      "directConnectGatewayState": "deleting"
  }
}

L’exemple de code suivant montre comment utiliser delete-interconnect.

AWS CLI

Pour supprimer une interconnexion

La commande delete-interconnect suivante supprime l’interconnexion spécifiée :

aws directconnect delete-interconnect --interconnect-id dxcon-fgktov66

Sortie :

{
    "interconnectState": "deleted"
}

  • Pour plus de détails sur l’API, consultez DeleteInterconnect dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-lag.

AWS CLI

Pour supprimer un LAG

L’exemple suivant supprime le LAG spécifié.

Commande :

aws directconnect delete-lag --lag-id dxlag-ffrhowd9

Sortie :

{
  "awsDevice": "EqDC2-4h6ce2r1bes6",
  "numberOfConnections": 0,
  "lagState": "deleted",
  "ownerAccount": "123456789012",
  "lagName": "TestLAG",
  "connections": [],
  "lagId": "dxlag-ffrhowd9",
  "minimumLinks": 0,
  "connectionsBandwidth": "1Gbps",
  "region": "us-east-1",
  "location": "EqDC2"
}

  • Pour plus de détails sur l’API, consultez DeleteLag dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-virtual-interface.

AWS CLI

Pour supprimer une interface virtuelle

La commande delete-virtual-interface suivante supprime l’interface virtuelle spécifiée :

aws directconnect delete-virtual-interface --virtual-interface-id dxvif-ffhhk74f

Sortie :

{
    "virtualInterfaceState": "deleting"
}

  • Pour plus de détails sur l’API, consultez DeleteVirtualInterface dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-connection-loa.

AWS CLI

Pour décrire votre LOA-CFA pour une connexion utilisant Linux ou Mac OS X

L’exemple suivant décrit votre LOA-CFA pour la connexion dxcon-fh6ayh1d. Les contenus de la LOA-CFA sont encodés en base64. Cette commande utilise les paramètres --output et --query pour contrôler la sortie et extraire le contenu de la structure loaContent. La dernière partie de la commande décode le contenu à l’aide de l’utilitaire base64 et envoie le résultat vers un fichier PDF.

aws directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf

Pour décrire votre LOA-CFA pour une connexion utilisant Windows

L’exemple précédent nécessite d’utiliser l’utilitaire base64 pour décoder la sortie. Sur un ordinateur Windows, vous pouvez utiliser certutil à la place. Dans l’exemple suivant, la première commande décrit votre LOA-CFA pour la connexion dxcon-fh6ayh1d et utilise les paramètres --output et --query pour contrôler la sortie et extraire le contenu de la structure loaContent 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 directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Pour plus d’informations sur le contrôle de la sortie de l’AWS CLI, consultez Contrôle de la sortie de commande de l’interface de ligne de commande AWS dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

  • Pour plus de détails sur l’API, consultez DescribeConnectionLoa dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-connections-on-interconnect.

AWS CLI

Pour répertorier les connexions sur une interconnexion

La commande describe-connections-on-interconnect suivante répertorie les connexions qui ont été provisionnées sur l’interconnexion donnée :

aws directconnect describe-connections-on-interconnect --interconnect-id dxcon-fgktov66

Sortie :

{
    "connections": [
        {
            "partnerName": "TIVIT",
            "vlan": 101,
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffzc51m1",
            "connectionState": "ordering",
            "bandwidth": "500Mbps",
            "location": "TIVIT",
            "connectionName": "mydcinterconnect",
            "region": "sa-east-1"
        }
    ]
}

L’exemple de code suivant montre comment utiliser describe-connections.

AWS CLI

Pour répertorier toutes les connexions dans la région actuelle

La commande describe-connections suivante répertorie toutes les connexions dans la région actuelle :

aws directconnect describe-connections

Sortie :

{
  "connections": [
      {
          "awsDevice": "EqDC2-123h49s71dabc",
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fguhmqlc",
          "lagId": "dxlag-ffrz71kw",
          "connectionState": "down",
          "bandwidth": "1Gbps",
          "location": "EqDC2",
          "connectionName": "My_Connection",
          "loaIssueTime": 1491568964.0,
          "region": "us-east-1"
      }
  ]
}

  • Pour plus de détails sur l’API, consultez DescribeConnections dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-direct-connect-gateway-association-proposals.

AWS CLI

Pour décrire vos propositions d’association de passerelle Direct Connect

L’exemple describe-direct-connect-gateway-association-proposals suivant affiche les informations sur vos propositions d’association de passerelles Direct Connect.

aws directconnect describe-direct-connect-gateway-association-proposals

Sortie :

{
    "directConnectGatewayAssociationProposals": [
        {
            "proposalId": "c2ede9b4-bbc6-4d33-923c-bc4feEXAMPLE",
            "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
            "directConnectGatewayOwnerAccount": "111122223333",
            "proposalState": "requested",
            "associatedGateway": {
                "id": "tgw-02f776b1a7EXAMPLE",
                "type": "transitGateway",
                "ownerAccount": "111122223333",
                "region": "us-east-1"
            },
            "existingAllowedPrefixesToDirectConnectGateway": [
                {
                    "cidr": "192.168.2.0/30"
                },
                {
                    "cidr": "192.168.1.0/30"
                }
            ],
            "requestedAllowedPrefixesToDirectConnectGateway": [
                {
                    "cidr": "192.168.1.0/30"
                }
            ]
        },
        {
            "proposalId": "cb7f41cb-8128-43a5-93b1-dcaedEXAMPLE",
            "directConnectGatewayId": "11560968-4ac1-4fd3-bcb2-00599EXAMPLE",
            "directConnectGatewayOwnerAccount": "111122223333",
            "proposalState": "accepted",
            "associatedGateway": {
                "id": "tgw-045776b1a7EXAMPLE",
                "type": "transitGateway",
                "ownerAccount": "111122223333",
                "region": "us-east-1"
            },
            "existingAllowedPrefixesToDirectConnectGateway": [
                {
                    "cidr": "192.168.4.0/30"
                },
                {
                    "cidr": "192.168.5.0/30"
                }
            ],
            "requestedAllowedPrefixesToDirectConnectGateway": [
                {
                    "cidr": "192.168.5.0/30"
                }
            ]
        }
    ]
}

Pour plus d’informations, consultez Association et dissociation de passerelles de transit dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser describe-direct-connect-gateway-associations.

AWS CLI

Pour décrire des associations de passerelle Direct Connect

L’exemple suivant décrit toutes les associations avec la passerelle Direct Connect 5f294f92-bafb-4011-916d-9b0bexample.

Commande :

aws directconnect describe-direct-connect-gateway-associations --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample

Sortie :

{
  "nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoiOU83OTFodzdycnZCbkN4MExHeHVwQT09IiwiYyI6InIxTEN0UEVHV0I1UFlkaWFnNlUxanJkRWF6eW1iOElHM0FRVW1MdHRJK0dxcnN1RWtvcFBKWFE2ZjRNRGdGTkhCa0tDZmVINEtZOEYwZ0dEYWZpbmU0ZnZMYVhKRjdXRVdENmdQZ1Y4d2w0PSJ9",
  "directConnectGatewayAssociations": [
      {
          "associationState": "associating",
          "virtualGatewayOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualGatewayId": "vgw-6efe725e",
          "virtualGatewayRegion": "us-east-2"
      },
      {
          "associationState": "disassociating",
          "virtualGatewayOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualGatewayId": "vgw-ebaa27db",
          "virtualGatewayRegion": "us-east-2"
      }
  ]
}

L’exemple de code suivant montre comment utiliser describe-direct-connect-gateway-attachments.

AWS CLI

Pour décrire les attachements à une passerelle Direct Connect

L’exemple suivant décrit les interfaces virtuelles attachées à la passerelle Direct Connect 5f294f92-bafb-4011-916d-9b0bexample.

Commande :

aws directconnect describe-direct-connect-gateway-attachments --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample

Sortie :

{
  "directConnectGatewayAttachments": [
      {
          "virtualInterfaceOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualInterfaceRegion": "us-east-2",
          "attachmentState": "attaching",
          "virtualInterfaceId": "dxvif-fg9zyabc"
      }
  ],
  "nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoibEhXdlNpUXF5RzhoL1JyUW52SlV2QT09IiwiYyI6Im5wQjFHQ0RyQUdRS3puNnNXcUlINCtkTTA4dTk3KzBiU0xtb05JQmlaczZ6NXRIYmk3c3VESUxFTTd6a2FzVHM0VTFwaGJkZGNxTytqWmQ3QzMzOGRQaTVrTThrOG1zelRsV3gyMWV3VTNFPSJ9"
}

L’exemple de code suivant montre comment utiliser describe-direct-connect-gateways.

AWS CLI

Pour décrire vos passerelles Direct Connect

L’exemple suivant décrit toutes vos passerelles Direct Connect.

Commande :

aws directconnect describe-direct-connect-gateways

Sortie :

{
  "directConnectGateways": [
      {
          "amazonSideAsn": 64512,
          "directConnectGatewayId": "cf68415c-f4ae-48f2-87a7-3b52cexample",
          "ownerAccount": "123456789012",
          "directConnectGatewayName": "DxGateway2",
          "directConnectGatewayState": "available"
      },
      {
          "amazonSideAsn": 64512,
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample",
          "ownerAccount": "123456789012",
          "directConnectGatewayName": "DxGateway1",
          "directConnectGatewayState": "available"
      }
  ]
}

L’exemple de code suivant montre comment utiliser describe-hosted-connections.

AWS CLI

Pour répertorier les connexions sur une interconnexion

L’exemple suivante répertorie les connexions qui ont été provisionnées sur l’interconnexion donnée.

Commande :

aws directconnect describe-hosted-connections --connection-id dxcon-fgktov66

Sortie :

{
    "connections": [
        {
            "partnerName": "TIVIT",
            "vlan": 101,
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffzc51m1",
            "connectionState": "ordering",
            "bandwidth": "500Mbps",
            "location": "TIVIT",
            "connectionName": "mydcinterconnect",
            "region": "sa-east-1"
        }
    ]
}

L’exemple de code suivant montre comment utiliser describe-interconnect-loa.

AWS CLI

Pour décrire votre LOA-CFA pour une interconnexion utilisant Linux ou Mac OS X

L’exemple suivant décrit votre LOA-CFA pour l’interconnexion dxcon-fh6ayh1d. Les contenus de la LOA-CFA sont encodés en base64. Cette commande utilise les paramètres --output et --query pour contrôler la sortie et extraire le contenu de la structure loaContent. La dernière partie de la commande décode le contenu à l’aide de l’utilitaire base64 et envoie le résultat vers un fichier PDF.

aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf

Pour décrire votre LOA-CFA pour une interconnexion utilisant Windows

L’exemple précédent nécessite d’utiliser l’utilitaire base64 pour décoder la sortie. Sur un ordinateur Windows, vous pouvez utiliser certutil à la place. Dans l’exemple suivant, la première commande décrit votre LOA-CFA pour l’interconnexion dxcon-fh6ayh1d, et utilise les paramètres --output et --query pour contrôler la sortie et extraire le contenu de la structure loaContent 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 directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Pour plus d’informations sur le contrôle de la sortie de l’AWS CLI, consultez Contrôle de la sortie de commande de l’interface de ligne de commande AWS dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

  • Pour plus de détails sur l’API, consultez DescribeInterconnectLoa dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-interconnects.

AWS CLI

Pour répertorier les interconnexions

La commande describe-interconnects suivante répertorie les interconnexions appartenant à votre compte AWS :

aws directconnect describe-interconnects

Sortie :

{
    "interconnects": [
        {
            "region": "sa-east-1",
            "bandwidth": "1Gbps",
            "location": "TIVIT",
            "interconnectName": "1G Interconnect to AWS",
            "interconnectId": "dxcon-fgktov66",
            "interconnectState": "down"
        }
    ]
}

  • Pour plus de détails sur l’API, consultez DescribeInterconnects dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-lags.

AWS CLI

Pour décrire vos LAG

La commande suivante décrit tous vos LAG pour la région actuelle.

Commande :

aws directconnect describe-lags

Sortie :

{
  "lags": [
      {
          "awsDevice": "EqDC2-19y7z3m17xpuz",
          "numberOfConnections": 2,
          "lagState": "down",
          "ownerAccount": "123456789012",
          "lagName": "DA-LAG",
          "connections": [
              {
                  "ownerAccount": "123456789012",
                  "connectionId": "dxcon-ffnikghc",
                  "lagId": "dxlag-fgsu9erb",
                  "connectionState": "requested",
                  "bandwidth": "10Gbps",
                  "location": "EqDC2",
                  "connectionName": "Requested Connection 1 for Lag dxlag-fgsu9erb",
                  "region": "us-east-1"
              },
              {
                  "ownerAccount": "123456789012",
                  "connectionId": "dxcon-fglgbdea",
                  "lagId": "dxlag-fgsu9erb",
                  "connectionState": "requested",
                  "bandwidth": "10Gbps",
                  "location": "EqDC2",
                  "connectionName": "Requested Connection 2 for Lag dxlag-fgsu9erb",
                  "region": "us-east-1"
              }
          ],
          "lagId": "dxlag-fgsu9erb",
          "minimumLinks": 0,
          "connectionsBandwidth": "10Gbps",
          "region": "us-east-1",
          "location": "EqDC2"
      }
  ]
}

  • Pour plus de détails sur l’API, consultez DescribeLags dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-loa.

AWS CLI

Pour décrire votre LOA-CFA pour une connexion utilisant Linux ou Mac OS X

L’exemple suivant décrit votre LOA-CFA pour la connexion dxcon-fh6ayh1d. Les contenus de la LOA-CFA sont encodés en base64. Cette commande utilise les paramètres --output et --query pour contrôler la sortie et extraire le contenu de la structure loaContent. La dernière partie de la commande décode le contenu à l’aide de l’utilitaire base64 et envoie le résultat vers un fichier PDF.

aws directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf

Pour décrire votre LOA-CFA pour une connexion utilisant Windows

L’exemple précédent nécessite d’utiliser l’utilitaire base64 pour décoder la sortie. Sur un ordinateur Windows, vous pouvez utiliser certutil à la place. Dans l’exemple suivant, la première commande décrit votre LOA-CFA pour la connexion dxcon-fh6ayh1d et utilise les paramètres --output et --query pour contrôler la sortie et extraire le contenu de la structure loaContent 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 directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Pour plus d’informations sur le contrôle de la sortie de l’AWS CLI, consultez Contrôle de la sortie de commande de l’interface de ligne de commande AWS dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

  • Pour plus de détails sur l’API, consultez DescribeLoa dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-locations.

AWS CLI

Pour répertorier les partenaires et les emplacements AWS Direct Connect

La commande describe-locations suivante répertorie les partenaires et les emplacements AWS Direct Connect dans la région actuelle :

aws directconnect describe-locations

Sortie :

{
    "locations": [
        {
            "locationName": "NAP do Brasil, Barueri, Sao Paulo",
            "locationCode": "TNDB"
        },
        {
            "locationName": "Tivit - Site Transamerica (Sao Paulo)",
            "locationCode": "TIVIT"
        }
    ]
}

  • Pour plus de détails sur l’API, consultez DescribeLocations dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-tags.

AWS CLI

Pour décrire les balises de vos ressources AWS Direct Connect

La commande suivante décrit les balises de la connexion dxcon-abcabc12.

Commande :

aws directconnect describe-tags --resource-arns arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12

Sortie :

{
  "resourceTags": [
      {
          "resourceArn": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12",
          "tags": [
              {
                  "value": "VAConnection",
                  "key": "Name"
              }
          ]
      }
  ]
}

  • Pour plus de détails sur l’API, consultez DescribeTags dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-virtual-gateways.

AWS CLI

Pour répertorier les passerelles privées virtuelles

La commande describe-virtual-gateways suivante répertorie les passerelles privées virtuelles appartenant à votre compte AWS :

aws directconnect describe-virtual-gateways

Sortie :

{
    "virtualGateways": [
        {
            "virtualGatewayId": "vgw-aba37db6",
            "virtualGatewayState": "available"
        }
    ]
}

  • Pour plus de détails sur l’API, consultez DescribeVirtualGateways dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-virtual-interfaces.

AWS CLI

Pour répertorier toutes les interfaces virtuelles

La commande describe-virtual-interfaces suivante répertorie les informations relatives à toutes les interfaces virtuelles associées à votre compte AWS :

aws directconnect describe-virtual-interfaces --connection-id dxcon-ffjrkx17

Sortie :

{
    "virtualInterfaces": [
        {
            "virtualInterfaceState": "down",
            "asn": 65000,
            "vlan": 101,
            "customerAddress": "192.168.1.2/30",
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffjrkx17",
            "virtualGatewayId": "vgw-aba37db6",
            "virtualInterfaceId": "dxvif-ffhhk74f",
            "authKey": "asdf34example",
            "routeFilterPrefixes": [],
            "location": "TIVIT",
            "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"
        },
        {
            "virtualInterfaceState": "verifying",
            "asn": 65000,
            "vlan": 2000,
            "customerAddress": "203.0.113.2/30",
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffjrkx17",
            "virtualGatewayId": "",
            "virtualInterfaceId": "dxvif-fgh0hcrk",
            "authKey": "asdf34example",
            "routeFilterPrefixes": [
                {
                    "cidr": "203.0.113.4/30"
                },
                {
                    "cidr": "203.0.113.0/30"
                }
            ],
            "location": "TIVIT",
            "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"
        }
    ]
}

L’exemple de code suivant montre comment utiliser disassociate-connection-from-lag.

AWS CLI

Pour dissocier une connexion d’un LAG

L’exemple suivant dissocie la connexion spécifiée du LAG spécifié.

Commande :

aws directconnect disassociate-connection-from-lag --lag-id dxlag-fhccu14t --connection-id  dxcon-fg9607vm

Sortie :

{
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "connectionState": "requested",
  "bandwidth": "1Gbps",
  "location": "EqDC2",
  "connectionName": "Con2ForLag",
  "region": "us-east-1"
}

L’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

Pour ajouter une balise à une ressource AWS Direct Connect

La commande suivante ajoute une balise avec une clé Name et une valeur VAConnection à la connexion dxcon-abcabc12. Si la commande réussit, aucune sortie n’est renvoyée.

Commande :

aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tags "key=Name,value=VAConnection"

  • Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

Pour supprimer une balise d’une ressource AWS Direct Connect

La commande suivante supprime la balise contenant la clé Name de la connexion dxcon-abcabc12. Si la commande réussit, aucune sortie n’est renvoyée.

Commande :

aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tag-keys Name

  • Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-direct-connect-gateway-association.

AWS CLI

Pour mettre à jour les attributs spécifiés de l’association de passerelle Direct Connect

L’exemple update-direct-connect-gateway-association suivant ajoute le bloc CIDR spécifié à une association de passerelle Direct Connect.

aws directconnect update-direct-connect-gateway-association \
    --association-id 820a6e4f-5374-4004-8317-3f64bEXAMPLE \
    --add-allowed-prefixes-to-direct-connect-gateway cidr=192.168.2.0/30

Sortie :

{
    "directConnectGatewayAssociation": {
        "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
        "directConnectGatewayOwnerAccount": "111122223333",
        "associationState": "updating",
        "associatedGateway": {
            "id": "tgw-02f776b1a7EXAMPLE",
            "type": "transitGateway",
            "ownerAccount": "111122223333",
            "region": "us-east-1"
        },
        "associationId": "820a6e4f-5374-4004-8317-3f64bEXAMPLE",
        "allowedPrefixesToDirectConnectGateway": [
            {
                "cidr": "192.168.2.0/30"
            },
            {
                "cidr": "192.168.1.0/30"
            }
        ]
    }
}

Pour plus d’informations, consultez Utilisation des passerelles Direct Connect dans le Guide de l’utilisateur AWS Direct Connect.

L’exemple de code suivant montre comment utiliser update-lag.

AWS CLI

Pour mettre à jour un LAG

L’exemple suivant modifie le nom du LAG spécifié.

Commande :

aws directconnect update-lag --lag-id dxlag-ffjhj9lx --lag-name 2ConnLag

Sortie :

{
  "awsDevice": "CSVA1-23u8tlpaz8iks",
  "numberOfConnections": 2,
  "lagState": "down",
  "ownerAccount": "123456789012",
  "lagName": "2ConnLag",
  "connections": [
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fflqyj95",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 2 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      },
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-ffqr6x5q",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 1 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      }
  ],
  "lagId": "dxlag-ffjhj9lx",
  "minimumLinks": 0,
  "connectionsBandwidth": "1Gbps",
  "region": "us-east-1",
  "location": "CSVA1"
}

  • Pour plus de détails sur l’API, consultez UpdateLag dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-virtual-interface-attributes.

AWS CLI

Pour mettre à jour la MTU d’une interface virtuelle

L’exemple update-virtual-interface-attributes suivant met à jour la MTU de l’interface virtuelle spécifiée.

aws directconnect update-virtual-interface-attributes \
    --virtual-interface-id dxvif-fEXAMPLE \
    --mtu 1500

Sortie :

{
    "ownerAccount": "1111222233333",
    "virtualInterfaceId": "dxvif-fEXAMPLE",
    "location": "loc1",
    "connectionId": "dxlag-fEXAMPLE",
    "virtualInterfaceType": "transit",
    "virtualInterfaceName": "example transit virtual interface",
    "vlan": 125,
    "asn": 650001,
    "amazonSideAsn": 64512,
    "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
    "amazonAddress": "169.254.248.1/30",
    "customerAddress": "169.254.248.2/30",
    "addressFamily": "ipv4",
    "virtualInterfaceState": "down",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fEXAMPLE\">\n  <vlan>125</vlan>\n  <customer_address>169.254.248.2/30</customer_address>\n  <amazon_address>169.254.248.1/30</amazon_address>\n  <bgp_asn>650001</bgp_asn>\n  <bgp_auth_key>0xzxgA9YoW9h58u8SEXAMPLE</bgp_auth_key>\n  <amazon_bgp_asn>64512</amazon_bgp_asn>\n  <connection_type>transit</connection_type>\n</logical_connection>\n",
    "mtu": 1500,
    "jumboFrameCapable": true,
    "virtualGatewayId": "",
    "directConnectGatewayId": "879b76a1-403d-4700-8b53-4a56ed85436e",
    "routeFilterPrefixes": [],
    "bgpPeers": [
        {
            "bgpPeerId": "dxpeer-fEXAMPLE",
            "asn": 650001,
            "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
            "addressFamily": "ipv4",
            "amazonAddress": "169.254.248.1/30",
            "customerAddress": "169.254.248.2/30",
            "bgpPeerState": "available",
            "bgpStatus": "down",
            "awsDeviceV2": "loc1-26wz6vEXAMPLE"
        }
    ],
    "region": "sa-east-1",
    "awsDeviceV2": "loc1-26wz6vEXAMPLE",
    "tags": []
}

Pour plus d’informations, consultez Définition de la MTU du réseau pour les interfaces virtuelles privées ou les interfaces de transit virtuelles dans le Guide de l’utilisateur AWS Direct Connect.