AWS Direct Connect exemples utilisant AWS CLI - AWS Command Line Interface
Actions

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.

AWS Direct Connect exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS Direct Connect.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliseraccept-direct-connect-gateway-association-proposal.

AWS CLI

Pour accepter une proposition d'association de passerelle

Ce qui suit accept-direct-connect-gateway-association-proposal 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, voir Accepter ou rejeter une proposition d'association de Transit Gateway dans le guide de l'utilisateur de AWS Direct Connect.

L'exemple de code suivant montre comment utiliserallocate-connection-on-interconnect.

AWS CLI

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

La allocate-connection-on-interconnect commande 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 utiliserallocate-hosted-connection.

AWS CLI

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

L'allocate-hosted-connectionexemple 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"
}

L'exemple de code suivant montre comment utiliserallocate-private-virtual-interface.

AWS CLI

Pour configurer une interface virtuelle privée

La allocate-private-virtual-interface commande suivante fournit une interface virtuelle privée qui appartiendra à 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 utiliserallocate-public-virtual-interface.

AWS CLI

Pour configurer une interface virtuelle publique

La allocate-public-virtual-interface commande suivante fournit une interface virtuelle publique appartenant à 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 utiliserallocate-transit-virtual-interface.

AWS CLI

Pour configurer une interface virtuelle de transit devant appartenir au AWS compte spécifié

L'allocate-transit-virtual-interfaceexemple suivant fournit 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 la section Création d'une interface virtuelle de transit hébergée dans le guide de l'utilisateur de AWS Direct Connect.

L'exemple de code suivant montre comment utiliserassociate-connection-with-lag.

AWS CLI

Pour associer une connexion à LAG

L'exemple suivant associe la connexion spécifiée à la connexion spécifiéeLAG.

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 utiliserassociate-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 à la connexion spécifiéeLAG.

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 utiliserassociate-virtual-interface.

AWS CLI

Pour associer une interface virtuelle à une connexion

L'exemple suivant associe l'interface virtuelle spécifiée à l'interface spécifiéeLAG. Sinon, pour associer l'interface virtuelle à une connexion, spécifiez 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 utiliserconfirm-connection.

AWS CLI

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

La confirm-connection commande 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 API plus de détails, voir ConfirmConnectionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserconfirm-private-virtual-interface.

AWS CLI

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

La confirm-private-virtual-interface commande 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 utiliserconfirm-public-virtual-interface.

AWS CLI

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

La confirm-public-virtual-interface commande 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 utiliserconfirm-transit-virtual-interface.

AWS CLI

Pour accepter la propriété d'une interface virtuelle de transport

Ce qui suit confirm-transit-virtual-interface accepte la propriété d'une interface virtuelle de transport 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 la section Acceptation d'une interface virtuelle hébergée dans le guide de l'utilisateur de AWS Direct Connect.

L'exemple de code suivant montre comment utilisercreate-bgp-peer.

AWS CLI

Pour créer une session IPv6 BGP de peering

L'exemple suivant crée une session de IPv6 BGP peering sur une interface dxvif-fg1vuj3d virtuelle privée. Les IPv6 adresses homologues sont automatiquement attribué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 API plus de détails, voir CreateBgpPeerla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-connection.

AWS CLI

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

La create-connection commande 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 API plus de détails, voir CreateConnectionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-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'create-direct-connect-gateway-association-proposalexemple 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 la section Création d'une proposition d'association Transit Gateway dans le guide de l'utilisateur de AWS Direct Connect.

L'exemple de code suivant montre comment utilisercreate-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 Connect5f294f92-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 utilisercreate-direct-connect-gateway.

AWS CLI

Pour créer une passerelle Direct Connect

L'exemple suivant crée une passerelle Direct Connect portant le nomDxGateway1.

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 utilisercreate-interconnect.

AWS CLI

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

La create-interconnect commande 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 API plus de détails, voir CreateInterconnectla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-lag.

AWS CLI

Pour créer un LAG avec de nouvelles connexions

L'exemple suivant crée LAG et demande deux nouvelles connexions AWS Direct Connect LAG 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 une connexion à LAG l'aide d'une connexion existante

L'exemple suivant crée une connexion LAG à partir d'une connexion existante dans votre compte et demande une deuxième nouvelle connexion LAG 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 API plus de détails, voir CreateLagla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-private-virtual-interface.

AWS CLI

Pour créer une interface virtuelle privée

La create-private-virtual-interface commande 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 utilisercreate-public-virtual-interface.

AWS CLI

Pour créer une interface virtuelle publique

La create-public-virtual-interface commande 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 utilisercreate-transit-virtual-interface.

AWS CLI

Pour créer une interface virtuelle de transport

L'create-transit-virtual-interfaceexemple 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 la section Création d'une interface virtuelle de transit vers la passerelle Direct Connect dans le guide de l'utilisateur de AWS Direct Connect.

L'exemple de code suivant montre comment utiliserdelete-bgp-peer.

AWS CLI

Pour supprimer un BGP homologue d'une interface virtuelle

L'exemple suivant supprime l'IPv6BGPhomologue de l'interface dxvif-fg1vuj3d virtuelle.

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 API plus de détails, voir DeleteBgpPeerla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-connection.

AWS CLI

Pour supprimer une connexion

La delete-connection commande 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 API plus de détails, voir DeleteConnectionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-direct-connect-gateway-association.

AWS CLI

Pour supprimer une association de passerelle Direct Connect

L'delete-direct-connect-gateway-associationexemple suivant supprime l'association de passerelle Direct Connect avec une passerelle de transit dont l'ID d'association est 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 la section Association et dissociation des passerelles de transport dans le guide de l'utilisateur de Direct AWS Connect.

L'exemple de code suivant montre comment utiliserdelete-direct-connect-gateway.

AWS CLI

Pour supprimer une passerelle Direct Connect

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

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 utiliserdelete-interconnect.

AWS CLI

Pour supprimer une interconnexion

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

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

Sortie :

{
    "interconnectState": "deleted"
}

  • Pour API plus de détails, voir DeleteInterconnectla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-lag.

AWS CLI

Pour supprimer un LAG

L'exemple suivant supprime le paramètre spécifiéLAG.

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 API plus de détails, voir DeleteLagla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-virtual-interface.

AWS CLI

Pour supprimer une interface virtuelle

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

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

Sortie :

{
    "virtualInterfaceState": "deleting"
}

L'exemple de code suivant montre comment utiliserdescribe-connection-loa.

AWS CLI

Pour décrire votreLOA, CFA pour une connexion utilisant Linux ou Mac OS X

L'exemple suivant décrit votre connexion LOA - CFA fordxcon-fh6ayh1d. Le contenu du LOA - est codé CFA en base64. Cette commande utilise les --query paramètres --output et pour contrôler la sortie et extraire le contenu de la loaContent structure. La dernière partie de la commande décode le contenu à l'aide de l'base64utilitaire et envoie le résultat dans un PDF fichier.

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 l'utilisation de l'base64utilitaire pour décoder la sortie. Sur un ordinateur Windows, vous pouvez utiliser à la certutil place. Dans l'exemple suivant, la première commande décrit votre connexion LOA - CFA for dxcon-fh6ayh1d et utilise les --query paramètres --output et pour contrôler la sortie et extraire le contenu de la loaContent structure dans un fichier appelémyLoaCfa.base64. La deuxième commande utilise l'certutilutilitaire pour décoder le fichier et envoyer le résultat dans un PDF fichier.

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 AWS CLI sortie, consultez la section Contrôle de la sortie de commande depuis l'interface de ligne de AWS commande dans le guide de l'utilisateur de l'interface de ligne de AWS commande.

L'exemple de code suivant montre comment utiliserdescribe-connections-on-interconnect.

AWS CLI

Pour répertorier les connexions sur une interconnexion

La describe-connections-on-interconnect commande suivante répertorie les connexions qui ont été configuré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 utiliserdescribe-connections.

AWS CLI

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

La describe-connections commande 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 API plus de détails, voir DescribeConnectionsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-direct-connect-gateway-association-proposals.

AWS CLI

Pour décrire vos propositions d'association de passerelles Direct Connect

L'describe-direct-connect-gateway-association-proposalsexemple suivant affiche les détails de 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 la section Association et dissociation des passerelles de transport dans le guide de l'utilisateur de Direct AWS Connect.

L'exemple de code suivant montre comment utiliserdescribe-direct-connect-gateway-associations.

AWS CLI

Pour décrire les associations de passerelles Direct Connect

L'exemple suivant décrit toutes les associations avec la passerelle Direct Connect5f294f92-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 utiliserdescribe-direct-connect-gateway-attachments.

AWS CLI

Pour décrire les pièces jointes de la passerelle Direct Connect

L'exemple suivant décrit les interfaces virtuelles connectées à la passerelle Direct Connect5f294f92-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 utiliserdescribe-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 utiliserdescribe-hosted-connections.

AWS CLI

Pour répertorier les connexions sur une interconnexion

L'exemple suivant répertorie les connexions qui ont été configuré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 utiliserdescribe-interconnect-loa.

AWS CLI

Pour décrire votre LOA : CFA pour une interconnexion sous Linux ou Mac OS X

L'exemple suivant décrit votre LOA - CFA pour l'interconnexiondxcon-fh6ayh1d. Le contenu du LOA - est codé CFA en base64. Cette commande utilise les --query paramètres --output et pour contrôler la sortie et extraire le contenu de la loaContent structure. La dernière partie de la commande décode le contenu à l'aide de l'base64utilitaire et envoie le résultat dans un PDF fichier.

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

Pour décrire votreLOA... CFA pour une interconnexion utilisant Windows

L'exemple précédent nécessite l'utilisation de l'base64utilitaire pour décoder la sortie. Sur un ordinateur Windows, vous pouvez utiliser à la certutil place. Dans l'exemple suivant, la première commande décrit votre LOA interconnexion dxcon-fh6ayh1d et utilise les --query paramètres --output et CFA pour contrôler la sortie et extraire le contenu de la loaContent structure dans un fichier appelémyLoaCfa.base64. La deuxième commande utilise l'certutilutilitaire pour décoder le fichier et envoyer le résultat dans un PDF fichier.

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 AWS CLI sortie, consultez la section Contrôle de la sortie de commande depuis l'interface de ligne de AWS commande dans le guide de l'utilisateur de l'interface de ligne de AWS commande.

L'exemple de code suivant montre comment utiliserdescribe-interconnects.

AWS CLI

Pour répertorier les interconnexions

La describe-interconnects commande suivante répertorie les interconnexions détenues par votre AWS compte :

aws directconnect describe-interconnects

Sortie :

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

L'exemple de code suivant montre comment utiliserdescribe-lags.

AWS CLI

Pour décrire votre LAGs

La commande suivante décrit tous vos paramètres LAGs pour la région en cours.

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 API plus de détails, voir DescribeLagsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-loa.

AWS CLI

Pour décrire votreLOA, CFA pour une connexion utilisant Linux ou Mac OS X

L'exemple suivant décrit votre connexion LOA - CFA fordxcon-fh6ayh1d. Le contenu du LOA - est codé CFA en base64. Cette commande utilise les --query paramètres --output et pour contrôler la sortie et extraire le contenu de la loaContent structure. La dernière partie de la commande décode le contenu à l'aide de l'base64utilitaire et envoie le résultat dans un PDF fichier.

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 l'utilisation de l'base64utilitaire pour décoder la sortie. Sur un ordinateur Windows, vous pouvez utiliser à la certutil place. Dans l'exemple suivant, la première commande décrit votre connexion LOA - CFA for dxcon-fh6ayh1d et utilise les --query paramètres --output et pour contrôler la sortie et extraire le contenu de la loaContent structure dans un fichier appelémyLoaCfa.base64. La deuxième commande utilise l'certutilutilitaire pour décoder le fichier et envoyer le résultat dans un PDF fichier.

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 AWS CLI sortie, consultez la section Contrôle de la sortie de commande depuis l'interface de ligne de AWS commande dans le guide de l'utilisateur de l'interface de ligne de AWS commande.

  • Pour API plus de détails, voir DescribeLoala section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-locations.

AWS CLI

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

La describe-locations commande suivante répertorie les partenaires et les sites 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 API plus de détails, voir DescribeLocationsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-tags.

AWS CLI

Pour décrire les balises associées à vos ressources AWS Direct Connect

La commande suivante décrit les balises de la connexiondxcon-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 API plus de détails, voir DescribeTagsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-virtual-gateways.

AWS CLI

Pour répertorier les passerelles privées virtuelles

La describe-virtual-gateways commande suivante répertorie les passerelles privées virtuelles détenues par votre AWS compte :

aws directconnect describe-virtual-gateways

Sortie :

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

L'exemple de code suivant montre comment utiliserdescribe-virtual-interfaces.

AWS CLI

Pour répertorier toutes les interfaces virtuelles

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

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 utiliserdisassociate-connection-from-lag.

AWS CLI

Pour dissocier une connexion d'un LAG

L'exemple suivant dissocie la connexion spécifiée de la connexion spécifiéeLAG.

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 utilisertag-resource.

AWS CLI

Pour ajouter un tag à une ressource AWS Direct Connect

La commande suivante ajoute une balise avec une clé Name et une valeur de VAConnection à la connexiondxcon-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 API plus de détails, voir TagResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer un tag d'une ressource AWS Direct Connect

La commande suivante supprime la balise contenant la clé Name de la connexiondxcon-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 API plus de détails, voir UntagResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-direct-connect-gateway-association.

AWS CLI

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

L'update-direct-connect-gateway-associationexemple suivant ajoute le CIDR bloc 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 la section Utilisation des passerelles Direct Connect dans le guide de l'utilisateur de AWS Direct Connect.

L'exemple de code suivant montre comment utiliserupdate-lag.

AWS CLI

Pour mettre à jour un LAG

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

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 API plus de détails, voir UpdateLagla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-virtual-interface-attributes.

AWS CLI

Pour mettre à MTU jour une interface virtuelle

L'update-virtual-interface-attributesexemple suivant met à jour MTU 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, voir Configuration du réseau MTU pour les interfaces virtuelles privées ou les interfaces virtuelles de transit dans le guide de l'utilisateur de AWS Direct Connect.