# Direct Connect Ejemplos de usando AWS CLI
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Direct Connect.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `accept-direct-connect-gateway-association-proposal`
En el siguiente ejemplo de código, se muestra cómo utilizar `accept-direct-connect-gateway-association-proposal`.
**AWS CLI**
**Aceptación de una propuesta de asociación de puerta de enlace**
En la siguiente `accept-direct-connect-gateway-association-proposal`, se acepta la propuesta especificada.
```
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"
}
]
}
}
```
Para obtener más información, consulte [Accepting or Rejecting a Transit Gateway Association Proposal](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-accept-reject-proposal) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [AcceptDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/accept-direct-connect-gateway-association-proposal.html) en la *Referencia de comandos de la AWS CLI*.
### `allocate-connection-on-interconnect`
En el siguiente ejemplo de código, se muestra cómo utilizar `allocate-connection-on-interconnect`.
**AWS CLI**
**Creación de una conexión alojada en una interconexión**
El siguiente comando `allocate-connection-on-interconnect` crea una conexión alojada en una interconexión:
```
aws directconnect allocate-connection-on-interconnect --bandwidth 500Mbps --connection-name mydcinterconnect --owner-account 123456789012 --interconnect-id dxcon-fgktov66 --vlan 101
```
Salida:
```
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
```
+ Para obtener detalles sobre la API, consulte [AllocateConnectionOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-connection-on-interconnect.html) en la *Referencia de comandos de la AWS CLI*.
### `allocate-hosted-connection`
En el siguiente ejemplo de código, se muestra cómo utilizar `allocate-hosted-connection`.
**AWS CLI**
**Creación de una conexión alojada en una interconexión**
En el siguiente ejemplo de `allocate-hosted-connection`, se crea una conexión alojada en la interconexión especificada.
```
aws directconnect allocate-hosted-connection \
--bandwidth 500Mbps \
--connection-name mydcinterconnect \
--owner-account 123456789012
-connection-id dxcon-fgktov66
-vlan 101
```
Salida:
```
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
```
+ Para obtener detalles sobre la API, consulte [AllocateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-hosted-connection.html) en la *Referencia de comandos de la AWS CLI*.
### `allocate-private-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `allocate-private-virtual-interface`.
**AWS CLI**
**Aprovisionamiento de una interfaz virtual privada**
El siguiente comando `allocate-private-virtual-interface` aprovisiona una interfaz virtual privada para que sea propiedad de otro cliente:
```
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
```
Salida:
```
{
"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": "\n \n 1000\n 192.168.1.2/30\n 192.168.1.1/30\n 65000\n asdf34example\n 7224\n private\n\n",
"amazonAddress": "192.168.1.1/30",
"virtualInterfaceType": "private",
"virtualInterfaceName": "PrivateVirtualInterface"
}
```
+ Para obtener detalles sobre la API, consulte [AllocatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-private-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `allocate-public-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `allocate-public-virtual-interface`.
**AWS CLI**
**Aprovisionamiento de una interfaz virtual pública**
El siguiente comando `allocate-public-virtual-interface` aprovisiona una interfaz virtual pública para que sea propiedad de otro cliente:
```
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}]
```
Salida:
```
{
"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": "\n\n 2000\n 203.0.113.2/30\n 203.0.113.1/30\n 65000\n asdf34example\n 7224\n public\n\n",
"amazonAddress": "203.0.113.1/30",
"virtualInterfaceType": "public",
"virtualInterfaceName": "PublicVirtualInterface"
}
```
+ Para obtener detalles sobre la API, consulte [AllocatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-public-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `allocate-transit-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `allocate-transit-virtual-interface`.
**AWS CLI**
**Aprovisionamiento de una interfaz virtual de tránsito para que sea propiedad de la cuenta AWS especificada.**
En el siguiente ejemplo de `allocate-transit-virtual-interface`, se proporciona una interfaz virtual de tránsito para la cuenta especificada.
```
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}]"
```
Salida:
```
{
"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": "\n\n 126\n 192.168.1.2/30\n 192.168.1.1/30\n 65110\n 0xzxgA9YoW9h58u8SEXAMPLE\n 7224\n transit\n\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"
}
]
}
}
```
Para obtener más información, consulte [Creating a Hosted Transit Virtual Interface](https://docs.aws.amazon.com/directconnect/latest/UserGuide/createhostedvirtualinterface.html#create-hosted-transit-vif) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [AllocateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-transit-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `associate-connection-with-lag`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-connection-with-lag`.
**AWS CLI**
**Asociación de una conexión a un LAG**
En el siguiente ejemplo, se asocia la conexión especificada con el LAG especificado.
Comando:
```
aws directconnect associate-connection-with-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm
```
Salida:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg9607vm",
"lagId": "dxlag-fhccu14t",
"connectionState": "requested",
"bandwidth": "1Gbps",
"location": "EqDC2",
"connectionName": "Con2ForLag",
"region": "us-east-1"
}
```
+ Para obtener detalles sobre la API, consulte [AssociateConnectionWithLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-connection-with-lag.html) en la *Referencia de comandos de la AWS CLI*.
### `associate-hosted-connection`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-hosted-connection`.
**AWS CLI**
**Asociación de una conexión alojada a un LAG**
En el siguiente ejemplo, se asocia la conexión alojada especificada con el LAG especificado.
Comando:
```
aws directconnect associate-hosted-connection --parent-connection-id dxlag-fhccu14t --connection-id dxcon-fg9607vm
```
Salida:
```
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg9607vm",
"lagId": "dxlag-fhccu14t",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
```
+ Para obtener detalles sobre la API, consulte [AssociateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-hosted-connection.html) en la *Referencia de comandos de la AWS CLI*.
### `associate-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-virtual-interface`.
**AWS CLI**
**Asociación de una interfaz virtual a una conexión**
En el siguiente ejemplo, se asocia la interfaz virtual especificada con el LAG especificado. Como alternativa, para asociar la interfaz virtual a una conexión, especifique el ID de una conexión de AWS Direct Connect para `--connection-id`; por ejemplo, `dxcon-ffnikghc`.
Comando:
```
aws directconnect associate-virtual-interface --connection-id dxlag-ffjhj9lx --virtual-interface-id dxvif-fgputw0j
```
Salida:
```
{
"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": "\n\n 123\n 169.254.255.2/30\n 169.254.255.1/30\n 65000\n 0x123pK5_VBqv.UQ3kJ4123_\n 7224\n private\n\n",
"amazonAddress": "169.254.255.1/30",
"virtualInterfaceType": "private",
"virtualInterfaceName": "VIF1A"
}
```
+ Para obtener detalles sobre la API, consulte [AssociateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `confirm-connection`
En el siguiente ejemplo de código, se muestra cómo utilizar `confirm-connection`.
**AWS CLI**
**Confirmación de la creación de una conexión alojada en una interconexión**
El siguiente comando `confirm-connection` confirma la creación de una conexión alojada en una interconexión:
```
aws directconnect confirm-connection --connection-id dxcon-fg2wi7hy
```
Salida:
```
{
"connectionState": "pending"
}
```
+ Para obtener detalles sobre la API, consulte [ConfirmConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-connection.html) en la *Referencia de comandos de la AWS CLI*.
### `confirm-private-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `confirm-private-virtual-interface`.
**AWS CLI**
**Aceptación de la propiedad de una interfaz virtual privada**
El siguiente comando `confirm-private-virtual-interface` acepta la propiedad de una interfaz virtual privada creada por otro cliente:
```
aws directconnect confirm-private-virtual-interface --virtual-interface-id dxvif-fgy8orxu --virtual-gateway-id vgw-e4a47df9
```
Salida:
```
{
"virtualInterfaceState": "pending"
}
```
+ Para obtener detalles sobre la API, consulte [ConfirmPrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-private-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `confirm-public-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `confirm-public-virtual-interface`.
**AWS CLI**
**Aceptación de la propiedad de una interfaz virtual pública**
El siguiente comando `confirm-public-virtual-interface` acepta la propiedad de una interfaz virtual pública creada por otro cliente:
```
aws directconnect confirm-public-virtual-interface --virtual-interface-id dxvif-fg9xo9vp
```
Salida:
```
{
"virtualInterfaceState": "verifying"
}
```
+ Para obtener detalles sobre la API, consulte [ConfirmPublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-public-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `confirm-transit-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `confirm-transit-virtual-interface`.
**AWS CLI**
**Aceptación de la propiedad de una interfaz virtual de tránsito**
La siguiente `confirm-transit-virtual-interface` acepta la propiedad de una interfaz virtual de tránsito creada por otro cliente.
```
aws directconnect confirm-transit-virtual-interface \
--virtual-interface-id dxvif-fEXAMPLE \
--direct-connect-gateway-id 4112ccf9-25e9-4111-8237-b6c5dEXAMPLE
```
Salida:
```
{
"virtualInterfaceState": "pending"
}
```
Para obtener más información, consulte [Accepting a Hosted Virtual Interface](https://docs.aws.amazon.com/directconnect/latest/UserGuide/accepthostedvirtualinterface.html) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [ConfirmTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-transit-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `create-bgp-peer`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-bgp-peer`.
**AWS CLI**
**Creación de una sesión de emparejamiento de BGP IPv6**
En el siguiente ejemplo, se crea una sesión de emparejamiento de BGP IPv6 en una interfaz virtual privada `dxvif-fg1vuj3d`. Amazon asigna automáticamente las direcciones IPv6 homólogas.
Comando:
```
aws directconnect create-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --new-bgp-peer asn=64600,addressFamily=ipv6
```
Salida:
```
{
"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": "\n\n 125\n 169.254.255.2/30\n 169.254.255.1/30\n 65000\n 0xC_ukbCerl6EYA0uexample\n 2001:db8:1100:2f0:0:1:9cb4:4216/125\n 2001:db8:1100:2f0:0:1:9cb4:4211/125\n 64600\n 0xS27kAIU_VHPjjAexample\n 7224\n private\n\n",
"amazonAddress": "169.254.255.1/30",
"virtualInterfaceType": "private",
"virtualInterfaceName": "Test"
}
}
```
+ Para obtener detalles sobre la API, consulte [CreateBgpPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-bgp-peer.html) en la *Referencia de comandos de la AWS CLI*.
### `create-connection`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-connection`.
**AWS CLI**
**Creación de una conexión de su red a una ubicación de AWS Direct Connect**
El siguiente comando `create-connection` crea una conexión de su red a una ubicación de AWS Direct Connect:
```
aws directconnect create-connection --location TIVIT --bandwidth 1Gbps --connection-name "Connection to AWS"
```
Salida:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg31dyv6",
"connectionState": "requested",
"bandwidth": "1Gbps",
"location": "TIVIT",
"connectionName": "Connection to AWS",
"region": "sa-east-1"
}
```
+ Para obtener más información sobre la API, consulte [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-connection.html) en la *Referencia de comandos de la AWS CLI*.
### `create-direct-connect-gateway-association-proposal`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-direct-connect-gateway-association-proposal`.
**AWS CLI**
**Creación de una propuesta para asociar la puerta de enlace de tránsito especificada con la puerta de enlace de Direct Connect especificada**
En el siguiente ejemplo de `create-direct-connect-gateway-association-proposal`, se crea una propuesta para asociar la puerta de enlace de tránsito especificada con la puerta de enlace de Direct Connect especificada.
```
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
```
Salida:
```
{
"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"
}
]
}
}
```
Para obtener más información, consulte [Creating a Transit Gateway Association Proposal](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-create-proposal) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [CreateDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association-proposal.html) en la *Referencia de comandos de la AWS CLI*.
### `create-direct-connect-gateway-association`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-direct-connect-gateway-association`.
**AWS CLI**
**Asociación de una puerta de enlace privada virtual con una puerta de enlace de Direct Connect**
En el siguiente ejemplo, se asocia la puerta de enlace privada virtual `vgw-6efe725e` con la puerta de enlace Direct Connect `5f294f92-bafb-4011-916d-9b0bexample`. Debe ejecutar el comando en la región en la que se encuentra la puerta de enlace privada virtual.
Comando:
```
aws directconnect create-direct-connect-gateway-association --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample --virtual-gateway-id vgw-6efe725e
```
Salida:
```
{
"directConnectGatewayAssociation": {
"associationState": "associating",
"virtualGatewayOwnerAccount": "123456789012",
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
"virtualGatewayId": "vgw-6efe725e",
"virtualGatewayRegion": "us-east-2"
}
}
```
+ Para obtener detalles sobre la API, consulte [CreateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association.html) en la *Referencia de comandos de la AWS CLI*.
### `create-direct-connect-gateway`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-direct-connect-gateway`.
**AWS CLI**
**Creación de una puerta de enlace de Direct Connect**
En el siguiente ejemplo, se crea una puerta de enlace de Direct Connect con el nombre`DxGateway1`.
Comando:
```
aws directconnect create-direct-connect-gateway --direct-connect-gateway-name "DxGateway1"
```
Salida:
```
{
"directConnectGateway": {
"amazonSideAsn": 64512,
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample",
"ownerAccount": "123456789012",
"directConnectGatewayName": "DxGateway1",
"directConnectGatewayState": "available"
}
}
```
+ Para obtener detalles sobre la API, consulte [CreateDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway.html) en la *Referencia de comandos de la AWS CLI*.
### `create-interconnect`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-interconnect`.
**AWS CLI**
**Creación de una interconexión entre la red de un socio y AWS**
El siguiente comando `create-interconnect` crea una nueva interconexión entre la red de un socio de AWS Direct Connect y una ubicación de AWS Direct Connect específica.
```
aws directconnect create-interconnect --interconnect-name "1G Interconnect to AWS" --bandwidth 1Gbps --location TIVIT
```
Salida:
```
{
"region": "sa-east-1",
"bandwidth": "1Gbps",
"location": "TIVIT",
"interconnectName": "1G Interconnect to AWS",
"interconnectId": "dxcon-fgktov66",
"interconnectState": "requested"
}
```
+ Para obtener detalles sobre la API, consulte [CreateInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-interconnect.html) en la *Referencia de comandos de la AWS CLI*.
### `create-lag`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-lag`.
**AWS CLI**
**Creación de un LAG con nuevas conexiones**
En el siguiente ejemplo, se crea un LAG y se solicitan dos nuevas conexiones de AWS Direct Connect para el LAG con un ancho de banda de 1 Gbps.
Comando:
```
aws directconnect create-lag --location CSVA1 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 1GBLag
```
Salida:
```
{
"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"
}
```
**Creación de un LAG con una conexión existente**
En el siguiente ejemplo, se crea un LAG a partir de una conexión existente en su cuenta y se solicita una segunda conexión nueva para el LAG con el mismo ancho de banda y la misma ubicación que la conexión existente.
Comando:
```
aws directconnect create-lag --location EqDC2 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 2ConnLAG --connection-id dxcon-fgk145dr
```
Salida:
```
{
"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"
}
```
+ Para obtener detalles sobre la API, consulte [CreateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-lag.html) en la *Referencia de comandos de la AWS CLI*.
### `create-private-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-private-virtual-interface`.
**AWS CLI**
**Creación de una interfaz virtual privada**
El siguiente comando `create-private-virtual-interface` crea una interfaz virtual privada:
```
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
```
Salida:
```
{
"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": "\n\n 101\n 192.168.1.2/30\n 192.168.1.1/30\n 65000\n asdf34example\n 7224\n private\n\n",
"amazonAddress": "192.168.1.1/30",
"virtualInterfaceType": "private",
"virtualInterfaceName": "PrivateVirtualInterface"
}
```
+ Para obtener detalles sobre la API, consulte [CreatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-private-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `create-public-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-public-virtual-interface`.
**AWS CLI**
**Creación de una interfaz virtual pública**
El siguiente comando `create-public-virtual-interface` crea una interfaz virtual pública:
```
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}]
```
Salida:
```
{
"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": "\n\n 2000\n 203.0.113.2/30\n 203.0.113.1/30\n 65000\n asdf34example\n 7224\n public\n\n",
"amazonAddress": "203.0.113.1/30",
"virtualInterfaceType": "public",
"virtualInterfaceName": "PublicVirtualInterface"
}
```
+ Para obtener detalles sobre la API, consulte [CreatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-public-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `create-transit-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-transit-virtual-interface`.
**AWS CLI**
**Creación de una interfaz virtual de tránsito**
En el siguiente ejemplo de `create-transit-virtual-interface`, se crea una interfaz virtual de tránsito para la conexión especificada.
```
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}]"
```
Salida:
```
{
"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": "\n\n 126\n 192.168.1.2/30\n 192.168.1.1/30\n 65110\n 0xzxgA9YoW9h58u8SvOmXRTw\n 4200000000\n transit\n\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"
}
]
}
}
```
Para obtener más información, consulte [Creating a Transit Virtual Interface to the Direct Connect Gateway](https://docs.aws.amazon.com/directconnect/latest/UserGuide/create-vif.html#create-transit-vif) en la *AWSGuía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [CreateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-transit-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-bgp-peer`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-bgp-peer`.
**AWS CLI**
**Eliminación de un par BGP de una interfaz virtual**
En el siguiente ejemplo, se elimina el par BGP IPv6 de la interfaz virtual `dxvif-fg1vuj3d`.
Comando:
```
aws directconnect delete-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --asn 64600 --customer-address 2001:db8:1100:2f0:0:1:9cb4:4216/125
```
Salida:
```
{
"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": "\n\n 125\n 169.254.255.2/30\n 169.254.255.1/30\n 65000\n 0xC_ukbCerl6EYA0example\n 7224\n private\n\n",
"amazonAddress": "169.254.255.1/30",
"virtualInterfaceType": "private",
"virtualInterfaceName": "Test"
}
}
```
+ Para obtener detalles sobre la API, consulte [DeleteBgpPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-bgp-peer.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-connection`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-connection`.
**AWS CLI**
**Para eliminar una conexión**
El siguiente comando `delete-connection` elimina la colección especificada:
```
aws directconnect delete-connection --connection-id dxcon-fg31dyv6
```
Salida:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg31dyv6",
"connectionState": "deleted",
"bandwidth": "1Gbps",
"location": "TIVIT",
"connectionName": "Connection to AWS",
"region": "sa-east-1"
}
```
+ Para obtener detalles sobre la API, consulte [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-connection.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-direct-connect-gateway-association`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-direct-connect-gateway-association`.
**AWS CLI**
**Eliminación de una asociación de puerta de enlace de Direct Connect**
En el siguiente ejemplo de `delete-direct-connect-gateway-association`, se elimina la asociación de la puerta de enlace de Direct Connect con una puerta de enlace de tránsito que tiene el ID de asociación especificado.
```
aws directconnect delete-direct-connect-gateway-association --association-id be85116d-46eb-4b43-a27a-da0c2ad648de
```
Salida:
```
{
"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"
}
]
}
}
```
Para obtener más información, consulte [Associating and Disassociating Transit Gateways](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [DeleteDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway-association.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-direct-connect-gateway`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-direct-connect-gateway`.
**AWS CLI**
**Eliminación de una puerta de enlace de Direct Connect**
En el siguiente ejemplo, se elimina la puerta de enlace `5f294f92-bafb-4011-916d-9b0bexample` de Direct Connect.
Comando:
```
aws directconnect delete-direct-connect-gateway --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample
```
Salida:
```
{
"directConnectGateway": {
"amazonSideAsn": 64512,
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
"ownerAccount": "123456789012",
"directConnectGatewayName": "DxGateway1",
"directConnectGatewayState": "deleting"
}
}
```
+ Para obtener detalles sobre la API, consulte [DeleteDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-interconnect`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-interconnect`.
**AWS CLI**
**Eliminación de una interconexión**
El siguiente comando `delete-interconnect` elimina la interconexión especificada:
```
aws directconnect delete-interconnect --interconnect-id dxcon-fgktov66
```
Salida:
```
{
"interconnectState": "deleted"
}
```
+ Para obtener detalles sobre la API, consulte [DeleteInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-interconnect.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-lag`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-lag`.
**AWS CLI**
**Eliminación de un LAG**
En el siguiente ejemplo, se elimina el LAG especificado.
Comando:
```
aws directconnect delete-lag --lag-id dxlag-ffrhowd9
```
Salida:
```
{
"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"
}
```
+ Para obtener detalles sobre la API, consulte [DeleteLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-lag.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-virtual-interface`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-virtual-interface`.
**AWS CLI**
**Eliminación de una interfaz virtual**
El siguiente comando `delete-virtual-interface` elimina la interfaz virtual especificada:
```
aws directconnect delete-virtual-interface --virtual-interface-id dxvif-ffhhk74f
```
Salida:
```
{
"virtualInterfaceState": "deleting"
}
```
+ Para obtener detalles sobre la API, consulte [DeleteVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-virtual-interface.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-connection-loa`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-connection-loa`.
**AWS CLI**
**Descripción de su LOA-CFA para una conexión mediante Linux o Mac OS X**
En el siguiente ejemplo, se describe el documento LOA-CFA para la conexión `dxcon-fh6ayh1d`. El contenido del documento LOA-CFA está codificado en base64. Este comando usa los parámetros `--output` y `--query` para controlar la salida y extraer el contenido de la estructura de `loaContent`. La última parte del comando decodifica el contenido mediante la utilidad `base64` y envía el resultado a un archivo PDF.
```
aws directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf
```
**Descripción de su documento LOA-CFA para una conexión mediante Windows**
El ejemplo anterior requiere el uso de la utilidad `base64` para decodificar la salida. En un equipo con Windows, puede usar `certutil` en su lugar. En el siguiente ejemplo, el primer comando describe su documento LOA-CFA para la conexión `dxcon-fh6ayh1d` y utiliza los parámetros `--output` y `--query` para controlar la salida y extraer el contenido de la estructura de `loaContent` en un archivo llamado `myLoaCfa.base64`. El segundo comando utiliza la utilidad `certutil` para decodificar el archivo y enviar el resultado a un archivo PDF.
```
aws directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64
```
```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Para obtener más información acerca del control de la salida de la CLI de AWS, consulte [Controlling Command Output from the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) en la *Guía del usuario de la interfaz de la línea de comandos de AWS*.
+ Para obtener detalles sobre la API, consulte [DescribeConnectionLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connection-loa.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-connections-on-interconnect`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-connections-on-interconnect`.
**AWS CLI**
**Para enumerar las conexiones de una interconexión**
El siguiente comando `describe-connections-on-interconnect` enumera las conexiones que se han aprovisionado en la interconexión especificada:
```
aws directconnect describe-connections-on-interconnect --interconnect-id dxcon-fgktov66
```
Salida:
```
{
"connections": [
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeConnectionsOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections-on-interconnect.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-connections`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-connections`.
**AWS CLI**
**Para enumerar todas las conexiones de la región actual**
El siguiente comando `describe-connections` muestra todas las conexiones de la región actual:
```
aws directconnect describe-connections
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-direct-connect-gateway-association-proposals`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-direct-connect-gateway-association-proposals`.
**AWS CLI**
**Descripción de sus propuestas de asociación de puerta de enlace de Direct Connect**
En el siguiente ejemplo de `describe-direct-connect-gateway-association-proposals`, se muestran detalles sobre sus propuestas de asociación de puertas de enlace de Direct Connect.
```
aws directconnect describe-direct-connect-gateway-association-proposals
```
Salida:
```
{
"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"
}
]
}
]
}
```
Para obtener más información, consulte [Associating and Disassociating Transit Gateways](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [DescribeDirectConnectGatewayAssociationProposals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-association-proposals.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-direct-connect-gateway-associations`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-direct-connect-gateway-associations`.
**AWS CLI**
**Descripción de asociaciones de puertas de enlace de Direct Connect**
En el siguiente ejemplo, se describen todas las asociaciones con una puerta de enlace de Direct Connect `5f294f92-bafb-4011-916d-9b0bexample`.
Comando:
```
aws directconnect describe-direct-connect-gateway-associations --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeDirectConnectGatewayAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-associations.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-direct-connect-gateway-attachments`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-direct-connect-gateway-attachments`.
**AWS CLI**
**Descripción de las vinculaciones de puertas de enlace de Direct Connect**
El siguiente ejemplo describe las interfaces virtuales que están vinculadas a la puerta de enlace Direct Connect `5f294f92-bafb-4011-916d-9b0bexample`.
Comando:
```
aws directconnect describe-direct-connect-gateway-attachments --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample
```
Salida:
```
{
"directConnectGatewayAttachments": [
{
"virtualInterfaceOwnerAccount": "123456789012",
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
"virtualInterfaceRegion": "us-east-2",
"attachmentState": "attaching",
"virtualInterfaceId": "dxvif-fg9zyabc"
}
],
"nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoibEhXdlNpUXF5RzhoL1JyUW52SlV2QT09IiwiYyI6Im5wQjFHQ0RyQUdRS3puNnNXcUlINCtkTTA4dTk3KzBiU0xtb05JQmlaczZ6NXRIYmk3c3VESUxFTTd6a2FzVHM0VTFwaGJkZGNxTytqWmQ3QzMzOGRQaTVrTThrOG1zelRsV3gyMWV3VTNFPSJ9"
}
```
+ Para obtener detalles sobre la API, consulte [DescribeDirectConnectGatewayAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-attachments.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-direct-connect-gateways`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-direct-connect-gateways`.
**AWS CLI**
**Descripción de sus puertas de enlace de Direct Connect**
En el siguiente ejemplo, se describen todas sus puertas de enlace de Direct Connect.
Comando:
```
aws directconnect describe-direct-connect-gateways
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeDirectConnectGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateways.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-hosted-connections`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-hosted-connections`.
**AWS CLI**
**Para enumerar las conexiones de una interconexión**
El siguiente ejemplo enumera las conexiones que se han aprovisionado en la interconexión especificada:
Comando:
```
aws directconnect describe-hosted-connections --connection-id dxcon-fgktov66
```
Salida:
```
{
"connections": [
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeHostedConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-hosted-connections.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-interconnect-loa`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-interconnect-loa`.
**AWS CLI**
**Descripción de su LOA-CFA para una conexión mediante Linux o Mac OS X**
En el siguiente ejemplo, se describe el documento LOA-CFA para la interconexión `dxcon-fh6ayh1d`. El contenido del documento LOA-CFA está codificado en base64. Este comando usa los parámetros `--output` y `--query` para controlar la salida y extraer el contenido de la estructura de `loaContent`. La última parte del comando decodifica el contenido mediante la utilidad `base64` y envía el resultado a un archivo PDF.
```
aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf
```
**Descripción de su documento LOA-CFA para una interconexión mediante Windows**
El ejemplo anterior requiere el uso de la utilidad `base64` para decodificar la salida. En un equipo con Windows, puede usar `certutil` en su lugar. En el siguiente ejemplo, el primer comando describe su documento LOA-CFA para la interconexión `dxcon-fh6ayh1d` y utiliza los parámetros `--output` y `--query` para controlar la salida y extraer el contenido de la estructura de `loaContent` en un archivo llamado `myLoaCfa.base64`. El segundo comando utiliza la utilidad `certutil` para decodificar el archivo y enviar el resultado a un archivo PDF.
```
aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64
```
```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Para obtener más información acerca del control de la salida de la CLI de AWS, consulte [Controlling Command Output from the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) en la *Guía del usuario de la interfaz de la línea de comandos de AWS*.
+ Para obtener detalles sobre la API, consulte [DescribeInterconnectLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnect-loa.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-interconnects`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-interconnects`.
**AWS CLI**
**Para enumerar las interconexiones**
El siguiente comando `describe-interconnects` muestra las interconexiones que pertenecen a su cuenta AWS:
```
aws directconnect describe-interconnects
```
Salida:
```
{
"interconnects": [
{
"region": "sa-east-1",
"bandwidth": "1Gbps",
"location": "TIVIT",
"interconnectName": "1G Interconnect to AWS",
"interconnectId": "dxcon-fgktov66",
"interconnectState": "down"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeInterconnects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnects.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-lags`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-lags`.
**AWS CLI**
**Descripción de sus LAG**
En el siguiente comando, se describen todos los LAG de la región actual.
Comando:
```
aws directconnect describe-lags
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeLags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-lags.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-loa`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-loa`.
**AWS CLI**
**Descripción de su LOA-CFA para una conexión mediante Linux o Mac OS X**
En el siguiente ejemplo, se describe el documento LOA-CFA para la conexión `dxcon-fh6ayh1d`. El contenido del documento LOA-CFA está codificado en base64. Este comando usa los parámetros `--output` y `--query` para controlar la salida y extraer el contenido de la estructura de `loaContent`. La última parte del comando decodifica el contenido mediante la utilidad `base64` y envía el resultado a un archivo PDF.
```
aws directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf
```
**Descripción de su documento LOA-CFA para una conexión mediante Windows**
El ejemplo anterior requiere el uso de la utilidad `base64` para decodificar la salida. En un equipo con Windows, puede usar `certutil` en su lugar. En el siguiente ejemplo, el primer comando describe su documento LOA-CFA para la conexión `dxcon-fh6ayh1d` y utiliza los parámetros `--output` y `--query` para controlar la salida y extraer el contenido de la estructura de `loaContent` en un archivo llamado `myLoaCfa.base64`. El segundo comando utiliza la utilidad `certutil` para decodificar el archivo y enviar el resultado a un archivo PDF.
```
aws directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64
```
```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Para obtener más información acerca del control de la salida de la CLI de AWS, consulte [Controlling Command Output from the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) en la *Guía del usuario de la interfaz de la línea de comandos de AWS*.
+ Para obtener detalles sobre la API, consulte [DescribeLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-loa.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-locations`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-locations`.
**AWS CLI**
**Para enumerar los socios y las ubicaciones de AWS Direct Connect**
El siguiente comando `describe-locations` enumera los socios y las ubicaciones de AWS Direct Connect en la región actual:
```
aws directconnect describe-locations
```
Salida:
```
{
"locations": [
{
"locationName": "NAP do Brasil, Barueri, Sao Paulo",
"locationCode": "TNDB"
},
{
"locationName": "Tivit - Site Transamerica (Sao Paulo)",
"locationCode": "TIVIT"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeLocations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-locations.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-tags`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-tags`.
**AWS CLI**
**Descripción de las etiquetas de sus recursos de AWS Direct Connect**
El siguiente comando describe las etiquetas de la conexión `dxcon-abcabc12`.
Comando:
```
aws directconnect describe-tags --resource-arns arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12
```
Salida:
```
{
"resourceTags": [
{
"resourceArn": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12",
"tags": [
{
"value": "VAConnection",
"key": "Name"
}
]
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-tags.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-virtual-gateways`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-virtual-gateways`.
**AWS CLI**
**Para enumerar las puertas de enlace privadas virtuales**
El siguiente comando `describe-virtual-gateways` enumera las puertas de enlace privadas virtuales que son propiedad de su cuenta de AWS:
```
aws directconnect describe-virtual-gateways
```
Salida:
```
{
"virtualGateways": [
{
"virtualGatewayId": "vgw-aba37db6",
"virtualGatewayState": "available"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeVirtualGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-gateways.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-virtual-interfaces`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-virtual-interfaces`.
**AWS CLI**
**Para enumerar todas las interfaces virtuales**
El siguiente comando `describe-virtual-interfaces` muestra la información sobre todas las interfaces virtuales asociadas a su cuenta de AWS:
```
aws directconnect describe-virtual-interfaces --connection-id dxcon-ffjrkx17
```
Salida:
```
{
"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": "\n\n 101\n 192.168.1.2/30\n 192.168.1.1/30\n 65000\n asdf34example\n 7224\n private\n\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": "\n\n 2000\n 203.0.113.2/30\n 203.0.113.1/30\n 65000\n asdf34example\n 7224\n public\n\n",
"amazonAddress": "203.0.113.1/30",
"virtualInterfaceType": "public",
"virtualInterfaceName": "PublicVirtualInterface"
}
]
}
```
+ Para obtener detalles sobre la API, consulte [DescribeVirtualInterfaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-interfaces.html) en la *Referencia de comandos de la AWS CLI*.
### `disassociate-connection-from-lag`
En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-connection-from-lag`.
**AWS CLI**
**Desasociar una conexión de un LAG**
En el siguiente ejemplo, se desasocia la conexión especificada del LAG indicado.
Comando:
```
aws directconnect disassociate-connection-from-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm
```
Salida:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg9607vm",
"connectionState": "requested",
"bandwidth": "1Gbps",
"location": "EqDC2",
"connectionName": "Con2ForLag",
"region": "us-east-1"
}
```
+ Para obtener detalles sobre la API, consulte [DisassociateConnectionFromLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/disassociate-connection-from-lag.html) en la *Referencia de comandos de la AWS CLI*.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Adición de una etiqueta a un recurso de AWS Direct Connect**
El siguiente comando agrega una etiqueta con una clave de `Name` y un valor de `VAConnection` a la instancia `dxcon-abcabc12`. Si el comando se ejecuta correctamente, no se muestra ningún resultado.
Comando:
```
aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tags "key=Name,value=VAConnection"
```
+ Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/tag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Eliminación de una etiqueta de un recurso de AWS Direct Connect**
El siguiente comando elimina la etiqueta con la clave `Name` de la conexión `dxcon-abcabc12`. Si el comando se ejecuta correctamente, no se muestra ningún resultado.
Comando:
```
aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tag-keys Name
```
+ Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/untag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `update-direct-connect-gateway-association`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-direct-connect-gateway-association`.
**AWS CLI**
**Actualización de los atributos especificados de la asociación de puertas de enlace de Direct Connect.**
En el siguiente ejemplo `update-direct-connect-gateway-association`, se agrega el bloque de CIDR especificado a una asociación de puertas de enlace de 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
```
Salida:
```
{
"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"
}
]
}
}
```
Para obtener más información, consulte [Working with Direct Connect Gateways](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-gateways.html) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [UpdateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-direct-connect-gateway-association.html) en la *Referencia de comandos de la AWS CLI*.
### `update-lag`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-lag`.
**AWS CLI**
**Actualización de un LAG**
En el siguiente ejemplo, se cambia el nombre del LAG especificado.
Comando:
```
aws directconnect update-lag --lag-id dxlag-ffjhj9lx --lag-name 2ConnLag
```
Salida:
```
{
"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"
}
```
+ Para obtener detalles sobre la API, consulte [UpdateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-lag.html) en la *Referencia de comandos de la AWS CLI*.
### `update-virtual-interface-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-virtual-interface-attributes`.
**AWS CLI**
**Actualización de la MTU de una interfaz virtual**
En el siguiente ejemplo `update-virtual-interface-attributes`, se actualiza la MTU de la interfaz virtual especificada.
```
aws directconnect update-virtual-interface-attributes \
--virtual-interface-id dxvif-fEXAMPLE \
--mtu 1500
```
Salida:
```
{
"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": "\n\n 125\n 169.254.248.2/30\n 169.254.248.1/30\n 650001\n 0xzxgA9YoW9h58u8SEXAMPLE\n 64512\n transit\n\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": []
}
```
Para obtener más información, consulte [Setting Network MTU for Private Virtual Interfaces or Transit Virtual Interfaces](https://docs.aws.amazon.com/directconnect/latest/UserGuide/set-jumbo-frames-vif.html) en la *Guía del usuario de AWS Direct Connect*.
+ Para obtener detalles sobre la API, consulte [UpdateVirtualInterfaceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-virtual-interface-attributes.html) en la *Referencia de comandos de la AWS CLI*.