View a markdown version of this page

Direct Connect exemples utilisant AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

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.

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 de AWS Command Line Interface with 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 utiliseraccept-direct-connect-gateway-association-proposal.

AWS CLI

Pour accepter une proposition d’association de passerelle

accept-direct-connect-gateway-association-proposal ci-dessous 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 utiliserallocate-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 utiliserallocate-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"
}

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

AWS CLI

Pour allouer une interface virtuelle privée

La commande allocate-private-virtual-interface suivante alloue 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 utiliserallocate-public-virtual-interface.

AWS CLI

Pour provisionner une interface virtuelle publique

La commande allocate-public-virtual-interface suivante alloue 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 utiliserallocate-transit-virtual-interface.

AWS CLI

Pour configurer une interface virtuelle de transit qui appartiendra au AWS compte spécifié

L’exemple allocate-transit-virtual-interface 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 Création d’une interface de transit virtuelle hébergée dans le AWS Guide de l’utilisateur AWS Direct Connect.

L'exemple de code suivant montre comment utiliserassociate-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 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 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 utiliserassociate-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é. 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 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 la 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 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 utiliserconfirm-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 utiliserconfirm-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 utilisercreate-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 la 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 emplacement AWS Direct Connect

La create-connection commande suivante permet de créer 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 la 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’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 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 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 utilisercreate-direct-connect-gateway.

AWS CLI

Pour créer une passerelle Direct Connect

L’exemple suivant crée une passerelle Direct Connect avec le nom 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 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 plus de détails sur l'API, consultez CreateInterconnect la 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 un LAG et demande deux nouvelles connexions AWS Direct Connect pour le 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 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 le 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 plus de détails sur l'API, consultez CreateLag la 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 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 utilisercreate-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 utilisercreate-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 utiliserdelete-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 la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-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 la 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’exemple delete-direct-connect-gateway-association 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 Association et dissociation de passerelles de transit dans le Guide de l’utilisateur AWS Direct 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 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 utiliserdelete-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 la 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 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 la 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 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"
}

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

AWS CLI

Pour décrire votre LOA-CFA demande de connexion sous Linux ou Mac OS X

L'exemple suivant décrit votre LOA-CFA connexiondxcon-fh6ayh1d. Le contenu du est codé LOA-CFA 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 en 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 demande de connexion à l'aide de Windows

L’exemple précédent nécessite d’utiliser l’utilitaire en 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 connexion LOA-CFA pour 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’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 AWS CLI, consultez la section Contrôle de la sortie des commandes 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 commande describe-connections-on-interconnect suivante répertorie les connexions qui ont été alloué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 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 la 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 passerelle Direct Connect

L’exemple describe-direct-connect-gateway-association-proposals suivant affiche des 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 utiliserdescribe-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 utiliserdescribe-direct-connect-gateway-attachments.

AWS CLI

Pour décrire des 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 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 suivante répertorie les connexions qui ont été alloué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 demande d'interconnexion sous Linux ou Mac OS X

L'exemple suivant décrit votre interconnexion LOA-CFA dxcon-fh6ayh1d pour. Le contenu du est codé LOA-CFA 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 en 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 demande LOA-CFA d'interconnexion à l'aide de Windows

L’exemple précédent nécessite d’utiliser l’utilitaire en 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 interconnexion LOA-CFA pour 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’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 AWS CLI, consultez la section Contrôle de la sortie des commandes 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 appartenant à 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 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 la section Référence des AWS CLI commandes.

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

AWS CLI

Pour décrire votre LOA-CFA demande de connexion sous Linux ou Mac OS X

L'exemple suivant décrit votre LOA-CFA connexiondxcon-fh6ayh1d. Le contenu du est codé LOA-CFA 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 en 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 demande de connexion à l'aide de Windows

L’exemple précédent nécessite d’utiliser l’utilitaire en 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 connexion LOA-CFA pour 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’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 AWS CLI, consultez la section Contrôle de la sortie des commandes depuis l'interface de ligne de AWS commande dans le Guide de l'utilisateur de l'interface de ligne de AWS commande.

  • Pour plus de détails sur l'API, consultez DescribeLoa la 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 plus de détails sur l'API, consultez DescribeLocations la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-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 la 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 appartenant à 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 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 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 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 la 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 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 la 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’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 utiliserupdate-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 la section Référence des AWS CLI commandes.

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

AWS CLI

Pour mettre à jour le MTU d’une interface virtuelle

L’exemple update-virtual-interface-attributes suivant met à jour le 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.