

D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/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
<a name="cli_2_direct-connect_code_examples"></a>

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

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `accept-direct-connect-gateway-association-proposal`
<a name="direct-connect_AcceptDirectConnectGatewayAssociationProposal_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`accept-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](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-accept-reject-proposal) dans le *Guide de l’utilisateur AWS  Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [AcceptDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/accept-direct-connect-gateway-association-proposal.html)à la section *Référence des AWS CLI commandes*. 

### `allocate-connection-on-interconnect`
<a name="direct-connect_AllocateConnectionOnInterconnect_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une connexion hébergée sur une interconnexion**  
La commande `allocate-connection-on-interconnect` suivante crée une connexion hébergée sur une interconnexion :  

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

```
{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}
```
+  Pour plus de détails sur l'API, reportez-vous [AllocateConnectionOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-connection-on-interconnect.html)à la section *Référence des AWS CLI commandes*. 

### `allocate-hosted-connection`
<a name="direct-connect_AllocateHostedConnection_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une connexion hébergée sur une interconnexion**  
L’exemple `allocate-hosted-connection` suivant crée une connexion hébergée sur l’interconnexion spécifiée.  

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

```
{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}
```
+  Pour plus de détails sur l'API, reportez-vous [AllocateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-hosted-connection.html)à la section *Référence des AWS CLI commandes*. 

### `allocate-private-virtual-interface`
<a name="direct-connect_AllocatePrivateVirtualInterface_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`allocate-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"
}
```
+  Pour plus de détails sur l'API, reportez-vous [AllocatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-private-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `allocate-public-virtual-interface`
<a name="direct-connect_AllocatePublicVirtualInterface_cli_2_topic"></a>

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

**AWS CLI**  
**Pour provisionner une interface virtuelle publique**  
La commande `allocate-public-virtual-interface` suivante 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"
}
```
+  Pour plus de détails sur l'API, reportez-vous [AllocatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-public-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `allocate-transit-virtual-interface`
<a name="direct-connect_AllocateTransitVirtualInterface_cli_2_topic"></a>

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

**AWS CLI**  
**Pour configurer une interface virtuelle de transit devant appartenir 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](https://docs.aws.amazon.com/directconnect/latest/UserGuide/createhostedvirtualinterface.html#create-hosted-transit-vif) dans le *AWS Guide de l’utilisateur AWS Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [AllocateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-transit-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `associate-connection-with-lag`
<a name="direct-connect_AssociateConnectionWithLag_cli_2_topic"></a>

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

**AWS CLI**  
**Pour associer une connexion à un LAG**  
L’exemple suivant associe la connexion spécifiée au LAG spécifié.  
Commande :  

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

```
{
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "lagId": "dxlag-fhccu14t",
  "connectionState": "requested",
  "bandwidth": "1Gbps",
  "location": "EqDC2",
  "connectionName": "Con2ForLag",
  "region": "us-east-1"
}
```
+  Pour plus de détails sur l'API, reportez-vous [AssociateConnectionWithLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-connection-with-lag.html)à la section *Référence des AWS CLI commandes*. 

### `associate-hosted-connection`
<a name="direct-connect_AssociateHostedConnection_cli_2_topic"></a>

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

**AWS CLI**  
**Pour associer une connexion hébergée à un LAG**  
L’exemple suivant associe la connexion hébergée spécifiée au LAG spécifié.  
Commande :  

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

```
{
  "partnerName": "TIVIT",
  "vlan": 101,
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "lagId": "dxlag-fhccu14t",
  "connectionState": "ordering",
  "bandwidth": "500Mbps",
  "location": "TIVIT",
  "connectionName": "mydcinterconnect",
  "region": "sa-east-1"
}
```
+  Pour plus de détails sur l'API, reportez-vous [AssociateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-hosted-connection.html)à la section *Référence des AWS CLI commandes*. 

### `associate-virtual-interface`
<a name="direct-connect_AssociateVirtualInterface_cli_2_topic"></a>

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

**AWS CLI**  
**Pour associer une interface virtuelle à une connexion**  
L’exemple suivant associe l’interface virtuelle spécifiée au LAG spécifié. 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"
}
```
+  Pour plus de détails sur l'API, reportez-vous [AssociateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `confirm-connection`
<a name="direct-connect_ConfirmConnection_cli_2_topic"></a>

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

**AWS CLI**  
**Pour confirmer la création d’une connexion hébergée sur une interconnexion**  
La commande `confirm-connection` suivante confirme la création d’une connexion hébergée sur une interconnexion :  

```
aws directconnect confirm-connection --connection-id dxcon-fg2wi7hy
```
Sortie :  

```
{
    "connectionState": "pending"
}
```
+  Pour plus de détails sur l'API, reportez-vous [ConfirmConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-connection.html)à la section *Référence des AWS CLI commandes*. 

### `confirm-private-virtual-interface`
<a name="direct-connect_ConfirmPrivateVirtualInterface_cli_2_topic"></a>

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

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

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

```
{
    "virtualInterfaceState": "pending"
}
```
+  Pour plus de détails sur l'API, reportez-vous [ConfirmPrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-private-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `confirm-public-virtual-interface`
<a name="direct-connect_ConfirmPublicVirtualInterface_cli_2_topic"></a>

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

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

```
aws directconnect confirm-public-virtual-interface --virtual-interface-id dxvif-fg9xo9vp
```
Sortie :  

```
{
    "virtualInterfaceState": "verifying"
}
```
+  Pour plus de détails sur l'API, reportez-vous [ConfirmPublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-public-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `confirm-transit-virtual-interface`
<a name="direct-connect_ConfirmTransitVirtualInterface_cli_2_topic"></a>

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

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

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

```
{
    "virtualInterfaceState": "pending"
}
```
Pour plus d’informations, consultez [Acceptation d’une interface virtuelle hébergée](https://docs.aws.amazon.com/directconnect/latest/UserGuide/accepthostedvirtualinterface.html) dans le *Guide de l’utilisateur AWS  Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [ConfirmTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-transit-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `create-bgp-peer`
<a name="direct-connect_CreateBgpPeer_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une session de IPv6 peering BGP**  
L'exemple suivant crée une session de peering IPv6 BGP sur une interface virtuelle privée. `dxvif-fg1vuj3d` 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 plus de détails sur l'API, reportez-vous [CreateBgpPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-bgp-peer.html)à la section *Référence des AWS CLI commandes*. 

### `create-connection`
<a name="direct-connect_CreateConnection_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`create-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 plus de détails sur l'API, reportez-vous [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-connection.html)à la section *Référence des AWS CLI commandes*. 

### `create-direct-connect-gateway-association-proposal`
<a name="direct-connect_CreateDirectConnectGatewayAssociationProposal_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une proposition visant à associer la passerelle de transit spécifiée à la passerelle Direct Connect spécifiée**  
L’exemple `create-direct-connect-gateway-association-proposal` suivant crée une proposition qui associe la passerelle de transit spécifiée à la passerelle Direct Connect spécifiée.  

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

```
{
    "directConnectGatewayAssociationProposal": {
        "proposalId": "cb7f41cb-8128-43a5-93b1-dcaedEXAMPLE",
        "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
        "directConnectGatewayOwnerAccount": "111122223333",
        "proposalState": "requested",
        "associatedGateway": {
            "id": "tgw-02f776b1a7EXAMPLE",
            "type": "transitGateway",
            "ownerAccount": "111122223333",
            "region": "us-east-1"
        },
        "requestedAllowedPrefixesToDirectConnectGateway": [
            {
                "cidr": "192.168.1.0/30"
            }
        ]
    }
}
```
Pour plus d’informations, consultez [Création d’une proposition d’association de la passerelle de transit](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-create-proposal) dans le *Guide de l’utilisateur AWS  Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [CreateDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association-proposal.html)à la section *Référence des AWS CLI commandes*. 

### `create-direct-connect-gateway-association`
<a name="direct-connect_CreateDirectConnectGatewayAssociation_cli_2_topic"></a>

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

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

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

```
{
  "directConnectGatewayAssociation": {
      "associationState": "associating",
      "virtualGatewayOwnerAccount": "123456789012",
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
      "virtualGatewayId": "vgw-6efe725e",
      "virtualGatewayRegion": "us-east-2"
  }
}
```
+  Pour plus de détails sur l'API, reportez-vous [CreateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association.html)à la section *Référence des AWS CLI commandes*. 

### `create-direct-connect-gateway`
<a name="direct-connect_CreateDirectConnectGateway_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une passerelle Direct Connect**  
L’exemple suivant crée une passerelle Direct Connect 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"
  }
}
```
+  Pour plus de détails sur l'API, reportez-vous [CreateDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway.html)à la section *Référence des AWS CLI commandes*. 

### `create-interconnect`
<a name="direct-connect_CreateInterconnect_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une interconnexion entre le réseau d'un partenaire et AWS**  
La `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, reportez-vous [CreateInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-interconnect.html)à la section *Référence des AWS CLI commandes*. 

### `create-lag`
<a name="direct-connect_CreateLag_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer un LAG avec de nouvelles connexions**  
L'exemple suivant crée un LAG et demande deux nouvelles connexions AWS Direct Connect pour 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, reportez-vous [CreateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-lag.html)à la section *Référence des AWS CLI commandes*. 

### `create-private-virtual-interface`
<a name="direct-connect_CreatePrivateVirtualInterface_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une interface virtuelle privée**  
La commande `create-private-virtual-interface` suivante crée une interface virtuelle privée :  

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

```
{
    "virtualInterfaceState": "pending",
    "asn": 65000,
    "vlan": 101,
    "customerAddress": "192.168.1.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualGatewayId": "vgw-aba37db6",
    "virtualInterfaceId": "dxvif-ffhhk74f",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-ffhhk74f\">\n  <vlan>101</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
    "amazonAddress": "192.168.1.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "PrivateVirtualInterface"
}
```
+  Pour plus de détails sur l'API, reportez-vous [CreatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-private-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `create-public-virtual-interface`
<a name="direct-connect_CreatePublicVirtualInterface_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une interface virtuelle publique**  
La commande `create-public-virtual-interface` suivante crée une interface virtuelle publique :  

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

```
{
    "virtualInterfaceState": "verifying",
    "asn": 65000,
    "vlan": 2000,
    "customerAddress": "203.0.113.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualInterfaceId": "dxvif-fgh0hcrk",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [
        {
            "cidr": "203.0.113.0/30"
        },
        {
            "cidr": "203.0.113.4/30"
        }
    ],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgh0hcrk\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
    "amazonAddress": "203.0.113.1/30",
    "virtualInterfaceType": "public",
    "virtualInterfaceName": "PublicVirtualInterface"
}
```
+  Pour plus de détails sur l'API, reportez-vous [CreatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-public-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `create-transit-virtual-interface`
<a name="direct-connect_CreateTransitVirtualInterface_cli_2_topic"></a>

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

**AWS CLI**  
**Pour créer une interface virtuelle de transit**  
L’exemple `create-transit-virtual-interface` suivant crée une interface virtuelle de transit pour la connexion spécifiée.  

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

```
{
    "virtualInterface": {
        "ownerAccount": "1111222233333",
        "virtualInterfaceId": "dxvif-fEXAMPLE",
        "location": "loc1",
        "connectionId": "dxlag-fEXAMPLE",
        "virtualInterfaceType": "transit",
        "virtualInterfaceName": "Example Transit Virtual Interface",
        "vlan": 126,
        "asn": 65110,
        "amazonSideAsn": 4200000000,
        "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
        "amazonAddress": "192.168.1.1/30",
        "customerAddress": "192.168.1.2/30",
        "addressFamily": "ipv4",
        "virtualInterfaceState": "pending",
        "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fEXAMPLE\">\n  <vlan>126</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65110</bgp_asn>\n  <bgp_auth_key>0xzxgA9YoW9h58u8SvOmXRTw</bgp_auth_key>\n  <amazon_bgp_asn>4200000000</amazon_bgp_asn>\n  <connection_type>transit</connection_type>\n</logical_connection>\n",
        "mtu": 1500,
        "jumboFrameCapable": true,
        "virtualGatewayId": "",
        "directConnectGatewayId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE",
        "routeFilterPrefixes": [],
        "bgpPeers": [
            {
                "bgpPeerId": "dxpeer-EXAMPLE",
                "asn": 65110,
                "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
                "addressFamily": "ipv4",
                "amazonAddress": "192.168.1.1/30",
                "customerAddress": "192.168.1.2/30",
                "bgpPeerState": "pending",
                "bgpStatus": "down",
                "awsDeviceV2": "loc1-26wz6vEXAMPLE"
            }
        ],
        "region": "sa-east-1",
        "awsDeviceV2": "loc1-26wz6vEXAMPLE",
        "tags": [
            {
                "key": "Tag",
                "value": "Example"
            }
        ]
    }
}
```
Pour plus d’informations, consultez [Création d’une interface de transit virtuelle vers la passerelle Direct Connect](https://docs.aws.amazon.com/directconnect/latest/UserGuide/create-vif.html#create-transit-vif) dans le *Guide de l’utilisateur AWS Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [CreateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-transit-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `delete-bgp-peer`
<a name="direct-connect_DeleteBgpPeer_cli_2_topic"></a>

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

**AWS CLI**  
**Pour supprimer un appairage BGP d’une interface virtuelle**  
L'exemple suivant supprime l'homologue IPv6 BGP 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, reportez-vous [DeleteBgpPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-bgp-peer.html)à la section *Référence des AWS CLI commandes*. 

### `delete-connection`
<a name="direct-connect_DeleteConnection_cli_2_topic"></a>

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

**AWS CLI**  
**Pour supprimer une connexion**  
La commande `delete-connection` suivante supprime la connexion spécifiée :  

```
aws directconnect delete-connection --connection-id dxcon-fg31dyv6
```
Sortie :  

```
{
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "connectionState": "deleted",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-connection.html)à la section *Référence des AWS CLI commandes*. 

### `delete-direct-connect-gateway-association`
<a name="direct-connect_DeleteDirectConnectGatewayAssociation_cli_2_topic"></a>

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

**AWS CLI**  
**Pour supprimer une association de passerelle Direct Connect**  
L’exemple `delete-direct-connect-gateway-association` suivant supprime l’association de passerelle Direct Connect avec 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](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) dans le *Guide de l’utilisateur AWS Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [DeleteDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway-association.html)à la section *Référence des AWS CLI commandes*. 

### `delete-direct-connect-gateway`
<a name="direct-connect_DeleteDirectConnectGateway_cli_2_topic"></a>

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

**AWS CLI**  
**Pour supprimer une passerelle Direct Connect**  
L’exemple suivant supprime la passerelle Direct Connect `5f294f92-bafb-4011-916d-9b0bexample`.  
Commande :  

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

```
{
  "directConnectGateway": {
      "amazonSideAsn": 64512,
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
      "ownerAccount": "123456789012",
      "directConnectGatewayName": "DxGateway1",
      "directConnectGatewayState": "deleting"
  }
}
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway.html)à la section *Référence des AWS CLI commandes*. 

### `delete-interconnect`
<a name="direct-connect_DeleteInterconnect_cli_2_topic"></a>

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

**AWS CLI**  
**Pour supprimer une interconnexion**  
La commande `delete-interconnect` suivante supprime l’interconnexion spécifiée :  

```
aws directconnect delete-interconnect --interconnect-id dxcon-fgktov66
```
Sortie :  

```
{
    "interconnectState": "deleted"
}
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-interconnect.html)à la section *Référence des AWS CLI commandes*. 

### `delete-lag`
<a name="direct-connect_DeleteLag_cli_2_topic"></a>

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

**AWS CLI**  
**Pour supprimer un LAG**  
L’exemple suivant supprime le LAG spécifié.  
Commande :  

```
aws directconnect delete-lag --lag-id dxlag-ffrhowd9
```
Sortie :  

```
{
  "awsDevice": "EqDC2-4h6ce2r1bes6",
  "numberOfConnections": 0,
  "lagState": "deleted",
  "ownerAccount": "123456789012",
  "lagName": "TestLAG",
  "connections": [],
  "lagId": "dxlag-ffrhowd9",
  "minimumLinks": 0,
  "connectionsBandwidth": "1Gbps",
  "region": "us-east-1",
  "location": "EqDC2"
}
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-lag.html)à la section *Référence des AWS CLI commandes*. 

### `delete-virtual-interface`
<a name="direct-connect_DeleteVirtualInterface_cli_2_topic"></a>

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

**AWS CLI**  
**Pour supprimer une interface virtuelle**  
La commande `delete-virtual-interface` suivante supprime l’interface virtuelle spécifiée :  

```
aws directconnect delete-virtual-interface --virtual-interface-id dxvif-ffhhk74f
```
Sortie :  

```
{
    "virtualInterfaceState": "deleting"
}
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-virtual-interface.html)à la section *Référence des AWS CLI commandes*. 

### `describe-connection-loa`
<a name="direct-connect_DescribeConnectionLoa_cli_2_topic"></a>

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

**AWS CLI**  
**Pour décrire votre LOA-CFA pour une connexion utilisant Linux ou Mac OS X**  
L’exemple suivant décrit votre LOA-CFA pour la connexion `dxcon-fh6ayh1d`. Les contenus de la LOA-CFA sont encodés en base64. Cette commande utilise les paramètres `--output` et `--query` pour contrôler la sortie et extraire le contenu de la structure `loaContent`. La dernière partie de la commande décode le contenu à l’aide de l’utilitaire 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 pour une connexion utilisant 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 LOA-CFA pour la connexion `dxcon-fh6ayh1d` et utilise les paramètres `--output` et `--query` pour contrôler la sortie et extraire le contenu de la structure `loaContent` dans un fichier appelé `myLoaCfa.base64`. La deuxième commande utilise l’utilitaire `certutil` pour décoder le fichier et envoyer le résultat vers un fichier PDF.  

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

```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Pour plus d'informations sur le contrôle de la sortie de la AWS CLI, consultez la section [Contrôle de la sortie de AWS commande depuis l'interface de ligne](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) de commande dans le *guide de l'utilisateur de l'interface de ligne de AWS commande*.  
+  Pour plus de détails sur l'API, reportez-vous [DescribeConnectionLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connection-loa.html)à la section *Référence des AWS CLI commandes*. 

### `describe-connections-on-interconnect`
<a name="direct-connect_DescribeConnectionsOnInterconnect_cli_2_topic"></a>

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

**AWS CLI**  
**Pour répertorier les connexions sur une interconnexion**  
La commande `describe-connections-on-interconnect` suivante répertorie les connexions qui ont été 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"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeConnectionsOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections-on-interconnect.html)à la section *Référence des AWS CLI commandes*. 

### `describe-connections`
<a name="direct-connect_DescribeConnections_cli_2_topic"></a>

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

**AWS CLI**  
**Pour répertorier toutes les connexions dans la région actuelle**  
La commande `describe-connections` suivante répertorie toutes les connexions dans la région actuelle :  

```
aws directconnect describe-connections
```
Sortie :  

```
{
  "connections": [
      {
          "awsDevice": "EqDC2-123h49s71dabc",
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fguhmqlc",
          "lagId": "dxlag-ffrz71kw",
          "connectionState": "down",
          "bandwidth": "1Gbps",
          "location": "EqDC2",
          "connectionName": "My_Connection",
          "loaIssueTime": 1491568964.0,
          "region": "us-east-1"
      }
  ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections.html)à la section *Référence des AWS CLI commandes*. 

### `describe-direct-connect-gateway-association-proposals`
<a name="direct-connect_DescribeDirectConnectGatewayAssociationProposals_cli_2_topic"></a>

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

**AWS CLI**  
**Pour décrire vos propositions d’association de passerelle Direct Connect**  
L’exemple `describe-direct-connect-gateway-association-proposals` suivant affiche 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](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) dans le *Guide de l’utilisateur AWS Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [DescribeDirectConnectGatewayAssociationProposals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-association-proposals.html)à la section *Référence des AWS CLI commandes*. 

### `describe-direct-connect-gateway-associations`
<a name="direct-connect_DescribeDirectConnectGatewayAssociations_cli_2_topic"></a>

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

**AWS CLI**  
**Pour décrire des associations de passerelle Direct Connect**  
L’exemple suivant décrit toutes les associations avec la passerelle Direct Connect `5f294f92-bafb-4011-916d-9b0bexample`.  
Commande :  

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

```
{
  "nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoiOU83OTFodzdycnZCbkN4MExHeHVwQT09IiwiYyI6InIxTEN0UEVHV0I1UFlkaWFnNlUxanJkRWF6eW1iOElHM0FRVW1MdHRJK0dxcnN1RWtvcFBKWFE2ZjRNRGdGTkhCa0tDZmVINEtZOEYwZ0dEYWZpbmU0ZnZMYVhKRjdXRVdENmdQZ1Y4d2w0PSJ9",
  "directConnectGatewayAssociations": [
      {
          "associationState": "associating",
          "virtualGatewayOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualGatewayId": "vgw-6efe725e",
          "virtualGatewayRegion": "us-east-2"
      },
      {
          "associationState": "disassociating",
          "virtualGatewayOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualGatewayId": "vgw-ebaa27db",
          "virtualGatewayRegion": "us-east-2"
      }
  ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeDirectConnectGatewayAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-associations.html)à la section *Référence des AWS CLI commandes*. 

### `describe-direct-connect-gateway-attachments`
<a name="direct-connect_DescribeDirectConnectGatewayAttachments_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-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"
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeDirectConnectGatewayAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-attachments.html)à la section *Référence des AWS CLI commandes*. 

### `describe-direct-connect-gateways`
<a name="direct-connect_DescribeDirectConnectGateways_cli_2_topic"></a>

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

**AWS CLI**  
**Pour décrire vos passerelles Direct Connect**  
L’exemple suivant décrit toutes vos passerelles Direct Connect.  
Commande :  

```
aws directconnect describe-direct-connect-gateways
```
Sortie :  

```
{
  "directConnectGateways": [
      {
          "amazonSideAsn": 64512,
          "directConnectGatewayId": "cf68415c-f4ae-48f2-87a7-3b52cexample",
          "ownerAccount": "123456789012",
          "directConnectGatewayName": "DxGateway2",
          "directConnectGatewayState": "available"
      },
      {
          "amazonSideAsn": 64512,
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample",
          "ownerAccount": "123456789012",
          "directConnectGatewayName": "DxGateway1",
          "directConnectGatewayState": "available"
      }
  ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeDirectConnectGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateways.html)à la section *Référence des AWS CLI commandes*. 

### `describe-hosted-connections`
<a name="direct-connect_DescribeHostedConnections_cli_2_topic"></a>

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

**AWS CLI**  
**Pour répertorier les connexions sur une interconnexion**  
L’exemple suivante répertorie les connexions qui ont été 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"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeHostedConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-hosted-connections.html)à la section *Référence des AWS CLI commandes*. 

### `describe-interconnect-loa`
<a name="direct-connect_DescribeInterconnectLoa_cli_2_topic"></a>

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

**AWS CLI**  
**Pour décrire votre LOA-CFA pour une interconnexion utilisant Linux ou Mac OS X**  
L’exemple suivant décrit votre LOA-CFA pour l’interconnexion `dxcon-fh6ayh1d`. Les contenus de la LOA-CFA sont encodés en base64. Cette commande utilise les paramètres `--output` et `--query` pour contrôler la sortie et extraire le contenu de la structure `loaContent`. La dernière partie de la commande décode le contenu à l’aide de l’utilitaire 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 LOA-CFA pour une interconnexion utilisant 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 LOA-CFA pour l’interconnexion `dxcon-fh6ayh1d` et utilise les paramètres `--output` et `--query` pour contrôler la sortie et extraire le contenu de la structure `loaContent` dans un fichier appelé `myLoaCfa.base64`. La deuxième commande utilise l’utilitaire `certutil` pour décoder le fichier et envoyer le résultat vers un fichier PDF.  

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

```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Pour plus d'informations sur le contrôle de la sortie de la AWS CLI, consultez la section [Contrôle de la sortie de AWS commande depuis l'interface de ligne](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) de commande dans le *guide de l'utilisateur de l'interface de ligne de AWS commande*.  
+  Pour plus de détails sur l'API, reportez-vous [DescribeInterconnectLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnect-loa.html)à la section *Référence des AWS CLI commandes*. 

### `describe-interconnects`
<a name="direct-connect_DescribeInterconnects_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-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"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeInterconnects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnects.html)à la section *Référence des AWS CLI commandes*. 

### `describe-lags`
<a name="direct-connect_DescribeLags_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-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 plus de détails sur l'API, reportez-vous [DescribeLags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-lags.html)à la section *Référence des AWS CLI commandes*. 

### `describe-loa`
<a name="direct-connect_DescribeLoa_cli_2_topic"></a>

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

**AWS CLI**  
**Pour décrire votre LOA-CFA pour une connexion utilisant Linux ou Mac OS X**  
L’exemple suivant décrit votre LOA-CFA pour la connexion `dxcon-fh6ayh1d`. Les contenus de la LOA-CFA sont encodés en base64. Cette commande utilise les paramètres `--output` et `--query` pour contrôler la sortie et extraire le contenu de la structure `loaContent`. La dernière partie de la commande décode le contenu à l’aide de l’utilitaire 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 pour une connexion utilisant 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 LOA-CFA pour la connexion `dxcon-fh6ayh1d` et utilise les paramètres `--output` et `--query` pour contrôler la sortie et extraire le contenu de la structure `loaContent` dans un fichier appelé `myLoaCfa.base64`. La deuxième commande utilise l’utilitaire `certutil` pour décoder le fichier et envoyer le résultat vers un fichier PDF.  

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

```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Pour plus d'informations sur le contrôle de la sortie de la AWS CLI, consultez la section [Contrôle de la sortie de AWS commande depuis l'interface de ligne](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) de commande dans le *guide de l'utilisateur de l'interface de ligne de AWS commande*.  
+  Pour plus de détails sur l'API, reportez-vous [DescribeLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-loa.html)à la section *Référence des AWS CLI commandes*. 

### `describe-locations`
<a name="direct-connect_DescribeLocations_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-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, reportez-vous [DescribeLocations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-locations.html)à la section *Référence des AWS CLI commandes*. 

### `describe-tags`
<a name="direct-connect_DescribeTags_cli_2_topic"></a>

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

**AWS CLI**  
**Pour décrire les balises associées à 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, reportez-vous [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-tags.html)à la section *Référence des AWS CLI commandes*. 

### `describe-virtual-gateways`
<a name="direct-connect_DescribeVirtualGateways_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-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"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeVirtualGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-gateways.html)à la section *Référence des AWS CLI commandes*. 

### `describe-virtual-interfaces`
<a name="direct-connect_DescribeVirtualInterfaces_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`describe-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"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeVirtualInterfaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-interfaces.html)à la section *Référence des AWS CLI commandes*. 

### `disassociate-connection-from-lag`
<a name="direct-connect_DisassociateConnectionFromLag_cli_2_topic"></a>

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

**AWS CLI**  
**Pour dissocier une connexion d’un LAG**  
L’exemple suivant dissocie la connexion spécifiée du LAG spécifié.  
Commande :  

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

```
{
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "connectionState": "requested",
  "bandwidth": "1Gbps",
  "location": "EqDC2",
  "connectionName": "Con2ForLag",
  "region": "us-east-1"
}
```
+  Pour plus de détails sur l'API, reportez-vous [DisassociateConnectionFromLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/disassociate-connection-from-lag.html)à la section *Référence des AWS CLI commandes*. 

### `tag-resource`
<a name="direct-connect_TagResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`tag-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, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/tag-resource.html)à la section *Référence des AWS CLI commandes*. 

### `untag-resource`
<a name="direct-connect_UntagResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`untag-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, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/untag-resource.html)à la section *Référence des AWS CLI commandes*. 

### `update-direct-connect-gateway-association`
<a name="direct-connect_UpdateDirectConnectGatewayAssociation_cli_2_topic"></a>

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

**AWS CLI**  
**Pour mettre à jour les attributs spécifiés de l’association de passerelle Direct Connect**  
L’exemple `update-direct-connect-gateway-association` suivant ajoute le bloc CIDR spécifié à une association de passerelle Direct Connect.  

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

```
{
    "directConnectGatewayAssociation": {
        "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
        "directConnectGatewayOwnerAccount": "111122223333",
        "associationState": "updating",
        "associatedGateway": {
            "id": "tgw-02f776b1a7EXAMPLE",
            "type": "transitGateway",
            "ownerAccount": "111122223333",
            "region": "us-east-1"
        },
        "associationId": "820a6e4f-5374-4004-8317-3f64bEXAMPLE",
        "allowedPrefixesToDirectConnectGateway": [
            {
                "cidr": "192.168.2.0/30"
            },
            {
                "cidr": "192.168.1.0/30"
            }
        ]
    }
}
```
Pour plus d’informations, consultez [Utilisation des passerelles Direct Connect](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-gateways.html) dans le *Guide de l’utilisateur AWS Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-direct-connect-gateway-association.html)à la section *Référence des AWS CLI commandes*. 

### `update-lag`
<a name="direct-connect_UpdateLag_cli_2_topic"></a>

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

**AWS CLI**  
**Pour mettre à jour un LAG**  
L’exemple suivant modifie le nom du LAG spécifié.  
Commande :  

```
aws directconnect update-lag --lag-id dxlag-ffjhj9lx --lag-name 2ConnLag
```
Sortie :  

```
{
  "awsDevice": "CSVA1-23u8tlpaz8iks",
  "numberOfConnections": 2,
  "lagState": "down",
  "ownerAccount": "123456789012",
  "lagName": "2ConnLag",
  "connections": [
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fflqyj95",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 2 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      },
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-ffqr6x5q",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 1 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      }
  ],
  "lagId": "dxlag-ffjhj9lx",
  "minimumLinks": 0,
  "connectionsBandwidth": "1Gbps",
  "region": "us-east-1",
  "location": "CSVA1"
}
```
+  Pour plus de détails sur l'API, reportez-vous [UpdateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-lag.html)à la section *Référence des AWS CLI commandes*. 

### `update-virtual-interface-attributes`
<a name="direct-connect_UpdateVirtualInterfaceAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-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](https://docs.aws.amazon.com/directconnect/latest/UserGuide/set-jumbo-frames-vif.html) dans le *Guide de l’utilisateur AWS Direct Connect*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateVirtualInterfaceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-virtual-interface-attributes.html)à la section *Référence des AWS CLI commandes*. 