Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Direct Connect exemplos usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with Direct Connect.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `accept-direct-connect-gateway-association-proposal`
O código de exemplo a seguir mostra como usar `accept-direct-connect-gateway-association-proposal`.
**AWS CLI**
**Como aceitar uma proposta de associação do gateway**
O `accept-direct-connect-gateway-association-proposal` a seguir aceita a proposta 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 obter mais informações, consulte [Aceitar ou rejeitar uma proposta de associação a um gateway de trânsito](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-accept-reject-proposal) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [AcceptDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/accept-direct-connect-gateway-association-proposal.html)na *Referência de AWS CLI Comandos*.
### `allocate-connection-on-interconnect`
O código de exemplo a seguir mostra como usar `allocate-connection-on-interconnect`.
**AWS CLI**
**Para criar uma conexão hospedada em uma interconexão**
O comando `allocate-connection-on-interconnect` a seguir cria uma conexão hospedada em uma interconexão:
```
aws directconnect allocate-connection-on-interconnect --bandwidth 500Mbps --connection-name mydcinterconnect --owner-account 123456789012 --interconnect-id dxcon-fgktov66 --vlan 101
```
Saída:
```
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
```
+ Para obter detalhes da API, consulte [AllocateConnectionOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-connection-on-interconnect.html)na *Referência de AWS CLI Comandos*.
### `allocate-hosted-connection`
O código de exemplo a seguir mostra como usar `allocate-hosted-connection`.
**AWS CLI**
**Para criar uma conexão hospedada em uma interconexão**
O exemplo `allocate-hosted-connection` a seguir cria uma conexão hospedada na interconexão especificada.
```
aws directconnect allocate-hosted-connection \
--bandwidth 500Mbps \
--connection-name mydcinterconnect \
--owner-account 123456789012
-connection-id dxcon-fgktov66
-vlan 101
```
Saída:
```
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
```
+ Para obter detalhes da API, consulte [AllocateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-hosted-connection.html)na *Referência de AWS CLI Comandos*.
### `allocate-private-virtual-interface`
O código de exemplo a seguir mostra como usar `allocate-private-virtual-interface`.
**AWS CLI**
**Como provisionar uma interface virtual privada**
O comando `allocate-private-virtual-interface` a seguir provisiona uma interface virtual privada para pertencer a outro 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
```
Saída:
```
{
"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 obter detalhes da API, consulte [AllocatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-private-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `allocate-public-virtual-interface`
O código de exemplo a seguir mostra como usar `allocate-public-virtual-interface`.
**AWS CLI**
**Como provisionar uma interface virtual pública**
O comando `allocate-public-virtual-interface` a seguir provisiona uma interface virtual pública para pertencer a outro 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}]
```
Saída:
```
{
"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 obter detalhes da API, consulte [AllocatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-public-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `allocate-transit-virtual-interface`
O código de exemplo a seguir mostra como usar `allocate-transit-virtual-interface`.
**AWS CLI**
**Para provisionar uma interface virtual de trânsito que pertença à AWS conta especificada**
O exemplo `allocate-transit-virtual-interface` a seguir provisiona uma interface virtual de trânsito para a conta 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}]"
```
Saída:
```
{
"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 obter informações, consulte [Criar uma interface virtual de trânsito hospedada](https://docs.aws.amazon.com/directconnect/latest/UserGuide/createhostedvirtualinterface.html#create-hosted-transit-vif) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [AllocateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/allocate-transit-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `associate-connection-with-lag`
O código de exemplo a seguir mostra como usar `associate-connection-with-lag`.
**AWS CLI**
**Como associar uma conexão a um LAG**
O exemplo a seguir associa a conexão especificada ao LAG especificado.
Comando:
```
aws directconnect associate-connection-with-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm
```
Saída:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg9607vm",
"lagId": "dxlag-fhccu14t",
"connectionState": "requested",
"bandwidth": "1Gbps",
"location": "EqDC2",
"connectionName": "Con2ForLag",
"region": "us-east-1"
}
```
+ Para obter detalhes da API, consulte [AssociateConnectionWithLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-connection-with-lag.html)em *Referência de AWS CLI Comandos*.
### `associate-hosted-connection`
O código de exemplo a seguir mostra como usar `associate-hosted-connection`.
**AWS CLI**
**Como associar uma conexão hospedada a um LAG**
O exemplo a seguir associa a conexão hospedada especificada ao LAG especificado.
Comando:
```
aws directconnect associate-hosted-connection --parent-connection-id dxlag-fhccu14t --connection-id dxcon-fg9607vm
```
Saída:
```
{
"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 obter detalhes da API, consulte [AssociateHostedConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-hosted-connection.html)em *Referência de AWS CLI Comandos*.
### `associate-virtual-interface`
O código de exemplo a seguir mostra como usar `associate-virtual-interface`.
**AWS CLI**
**Como associar uma interface virtual a uma conexão**
O exemplo a seguir associa a interface virtual especificada ao LAG especificado. Como alternativa, para associar a interface virtual a uma conexão, especifique o ID de uma conexão AWS Direct Connect para`--connection-id`; por exemplo,`dxcon-ffnikghc`.
Comando:
```
aws directconnect associate-virtual-interface --connection-id dxlag-ffjhj9lx --virtual-interface-id dxvif-fgputw0j
```
Saída:
```
{
"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 obter detalhes da API, consulte [AssociateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/associate-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `confirm-connection`
O código de exemplo a seguir mostra como usar `confirm-connection`.
**AWS CLI**
**Como confirmar a criação de uma conexão hospedada em uma interconexão**
O comando `confirm-connection` a seguir confirma a criação de uma conexão hospedada em uma interconexão:
```
aws directconnect confirm-connection --connection-id dxcon-fg2wi7hy
```
Saída:
```
{
"connectionState": "pending"
}
```
+ Para obter detalhes da API, consulte [ConfirmConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-connection.html)em *Referência de AWS CLI Comandos*.
### `confirm-private-virtual-interface`
O código de exemplo a seguir mostra como usar `confirm-private-virtual-interface`.
**AWS CLI**
**Como aceitar a propriedade de uma interface virtual privada**
O comando `confirm-private-virtual-interface` a seguir aceita a propriedade de uma interface virtual privada criada por outro cliente:
```
aws directconnect confirm-private-virtual-interface --virtual-interface-id dxvif-fgy8orxu --virtual-gateway-id vgw-e4a47df9
```
Saída:
```
{
"virtualInterfaceState": "pending"
}
```
+ Para obter detalhes da API, consulte [ConfirmPrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-private-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `confirm-public-virtual-interface`
O código de exemplo a seguir mostra como usar `confirm-public-virtual-interface`.
**AWS CLI**
**Como aceitar a propriedade de uma interface virtual pública**
O comando `confirm-public-virtual-interface` a seguir aceita a propriedade de uma interface virtual pública criada por outro cliente:
```
aws directconnect confirm-public-virtual-interface --virtual-interface-id dxvif-fg9xo9vp
```
Saída:
```
{
"virtualInterfaceState": "verifying"
}
```
+ Para obter detalhes da API, consulte [ConfirmPublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-public-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `confirm-transit-virtual-interface`
O código de exemplo a seguir mostra como usar `confirm-transit-virtual-interface`.
**AWS CLI**
**Como aceitar a propriedade de uma interface virtual em trânsito**
O `confirm-transit-virtual-interface` a seguir aceita a propriedade de uma interface virtual de trânsito criada por outro cliente.
```
aws directconnect confirm-transit-virtual-interface \
--virtual-interface-id dxvif-fEXAMPLE \
--direct-connect-gateway-id 4112ccf9-25e9-4111-8237-b6c5dEXAMPLE
```
Saída:
```
{
"virtualInterfaceState": "pending"
}
```
Para obter informações, consulte [Aceitar uma interface virtual hospedada](https://docs.aws.amazon.com/directconnect/latest/UserGuide/accepthostedvirtualinterface.html) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [ConfirmTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/confirm-transit-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `create-bgp-peer`
O código de exemplo a seguir mostra como usar `create-bgp-peer`.
**AWS CLI**
**Para criar uma sessão de IPv6 emparelhamento do BGP**
O exemplo a seguir cria uma sessão de emparelhamento IPv6 BGP em uma interface virtual privada. `dxvif-fg1vuj3d` Os IPv6 endereços dos pares são alocados automaticamente pela Amazon.
Comando:
```
aws directconnect create-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --new-bgp-peer asn=64600,addressFamily=ipv6
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateBgpPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-bgp-peer.html)em *Referência de AWS CLI Comandos*.
### `create-connection`
O código de exemplo a seguir mostra como usar `create-connection`.
**AWS CLI**
**Para criar uma conexão da sua rede com um local do AWS Direct Connect**
O `create-connection` comando a seguir cria uma conexão da sua rede com um local do AWS Direct Connect:
```
aws directconnect create-connection --location TIVIT --bandwidth 1Gbps --connection-name "Connection to AWS"
```
Saída:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg31dyv6",
"connectionState": "requested",
"bandwidth": "1Gbps",
"location": "TIVIT",
"connectionName": "Connection to AWS",
"region": "sa-east-1"
}
```
+ Para obter detalhes da API, consulte [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-connection.html)em *Referência de AWS CLI Comandos*.
### `create-direct-connect-gateway-association-proposal`
O código de exemplo a seguir mostra como usar `create-direct-connect-gateway-association-proposal`.
**AWS CLI**
**Para criar uma proposta para associar o gateway de trânsito ao gateway do Direct Connect**
O exemplo `create-direct-connect-gateway-association-proposal` a seguir cria uma proposta que associa o gateway de trânsito especificado ao gateway do Direct Connect especificado.
```
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
```
Saída:
```
{
"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 obter mais informações, consulte [Criar uma proposta de associação a um gateway de trânsito](https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-tgw.html#multi-account-tgw-create-proposal) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [CreateDirectConnectGatewayAssociationProposal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association-proposal.html)em *Referência de AWS CLI Comandos*.
### `create-direct-connect-gateway-association`
O código de exemplo a seguir mostra como usar `create-direct-connect-gateway-association`.
**AWS CLI**
**Como associar um gateway privado virtual a um gateway do Direct Connect**
O exemplo a seguir associa o gateway privado virtual `vgw-6efe725e` ao gateway Direct Connect `5f294f92-bafb-4011-916d-9b0bexample`. Você deve executar o comando na região em que o gateway privado virtual está localizado.
Comando:
```
aws directconnect create-direct-connect-gateway-association --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample --virtual-gateway-id vgw-6efe725e
```
Saída:
```
{
"directConnectGatewayAssociation": {
"associationState": "associating",
"virtualGatewayOwnerAccount": "123456789012",
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
"virtualGatewayId": "vgw-6efe725e",
"virtualGatewayRegion": "us-east-2"
}
}
```
+ Para obter detalhes da API, consulte [CreateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway-association.html)em *Referência de AWS CLI Comandos*.
### `create-direct-connect-gateway`
O código de exemplo a seguir mostra como usar `create-direct-connect-gateway`.
**AWS CLI**
**Para criar um gateway Direct Connect**
O exemplo a seguir cria um gateway do Direct Connect com o nome `DxGateway1`.
Comando:
```
aws directconnect create-direct-connect-gateway --direct-connect-gateway-name "DxGateway1"
```
Saída:
```
{
"directConnectGateway": {
"amazonSideAsn": 64512,
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample",
"ownerAccount": "123456789012",
"directConnectGatewayName": "DxGateway1",
"directConnectGatewayState": "available"
}
}
```
+ Para obter detalhes da API, consulte [CreateDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-direct-connect-gateway.html)em *Referência de AWS CLI Comandos*.
### `create-interconnect`
O código de exemplo a seguir mostra como usar `create-interconnect`.
**AWS CLI**
**Para criar uma interconexão entre a rede de um parceiro e AWS**
O `create-interconnect` comando a seguir cria uma interconexão entre a rede de um parceiro do AWS Direct Connect e um local específico do AWS Direct Connect:
```
aws directconnect create-interconnect --interconnect-name "1G Interconnect to AWS" --bandwidth 1Gbps --location TIVIT
```
Saída:
```
{
"region": "sa-east-1",
"bandwidth": "1Gbps",
"location": "TIVIT",
"interconnectName": "1G Interconnect to AWS",
"interconnectId": "dxcon-fgktov66",
"interconnectState": "requested"
}
```
+ Para obter detalhes da API, consulte [CreateInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-interconnect.html)em *Referência de AWS CLI Comandos*.
### `create-lag`
O código de exemplo a seguir mostra como usar `create-lag`.
**AWS CLI**
**Para criar um LAG com novas conexões**
O exemplo a seguir cria um LAG e solicita duas novas conexões AWS Direct Connect para o LAG com uma largura de banda de 1 Gbps.
Comando:
```
aws directconnect create-lag --location CSVA1 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 1GBLag
```
Saída:
```
{
"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"
}
```
**Para criar um LAG usando uma conexão existente**
O exemplo a seguir cria um LAG a partir de uma conexão existente em sua conta e solicita uma segunda nova conexão para o LAG com a mesma largura de banda e localização da conexão existente.
Comando:
```
aws directconnect create-lag --location EqDC2 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 2ConnLAG --connection-id dxcon-fgk145dr
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-lag.html)em *Referência de AWS CLI Comandos*.
### `create-private-virtual-interface`
O código de exemplo a seguir mostra como usar `create-private-virtual-interface`.
**AWS CLI**
**Para criar uma interface virtual privada**
O comando `create-private-virtual-interface` a seguir cria uma interface 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
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreatePrivateVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-private-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `create-public-virtual-interface`
O código de exemplo a seguir mostra como usar `create-public-virtual-interface`.
**AWS CLI**
**Para criar uma interface virtual pública**
O comando `create-public-virtual-interface` a seguir cria uma interface 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}]
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreatePublicVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-public-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `create-transit-virtual-interface`
O código de exemplo a seguir mostra como usar `create-transit-virtual-interface`.
**AWS CLI**
**Para criar uma interface virtual de trânsito**
O exemplo `create-transit-virtual-interface` a seguir cria uma interface virtual de trânsito para a conexão 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}]"
```
Saída:
```
{
"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 obter informações, consulte [Criar uma interface virtual de gateway do Direct Connect](https://docs.aws.amazon.com/directconnect/latest/UserGuide/create-vif.html#create-transit-vif) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [CreateTransitVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/create-transit-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `delete-bgp-peer`
O código de exemplo a seguir mostra como usar `delete-bgp-peer`.
**AWS CLI**
**Para excluir um pareamento BGP de uma interface virtual**
O exemplo a seguir exclui o peer IPv6 BGP da interface 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
```
Saída:
```
{
"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 obter detalhes da API, consulte [DeleteBgpPeer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-bgp-peer.html)em *Referência de AWS CLI Comandos*.
### `delete-connection`
O código de exemplo a seguir mostra como usar `delete-connection`.
**AWS CLI**
**Para excluir uma conexão**
O comando `delete-connection` a seguir exclui a conexão especificada.
```
aws directconnect delete-connection --connection-id dxcon-fg31dyv6
```
Saída:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg31dyv6",
"connectionState": "deleted",
"bandwidth": "1Gbps",
"location": "TIVIT",
"connectionName": "Connection to AWS",
"region": "sa-east-1"
}
```
+ Para obter detalhes da API, consulte [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-connection.html)em *Referência de AWS CLI Comandos*.
### `delete-direct-connect-gateway-association`
O código de exemplo a seguir mostra como usar `delete-direct-connect-gateway-association`.
**AWS CLI**
**Para excluir uma associação de gateway do Direct Connect**
O exemplo `delete-direct-connect-gateway-association` a seguir exclui a associação do gateway do Direct Connect com um gateway de trânsito que tem o ID de associação especificado.
```
aws directconnect delete-direct-connect-gateway-association --association-id be85116d-46eb-4b43-a27a-da0c2ad648de
```
Saída:
```
{
"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 obter mais informações, consulte [Associar e desassociar gateways de trânsito](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [DeleteDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway-association.html)em *Referência de AWS CLI Comandos*.
### `delete-direct-connect-gateway`
O código de exemplo a seguir mostra como usar `delete-direct-connect-gateway`.
**AWS CLI**
**Para excluir um gateway do Direct Connect**
O exemplo a seguir exclui o gateway `5f294f92-bafb-4011-916d-9b0bexample` do Direct Connect.
Comando:
```
aws directconnect delete-direct-connect-gateway --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample
```
Saída:
```
{
"directConnectGateway": {
"amazonSideAsn": 64512,
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
"ownerAccount": "123456789012",
"directConnectGatewayName": "DxGateway1",
"directConnectGatewayState": "deleting"
}
}
```
+ Para obter detalhes da API, consulte [DeleteDirectConnectGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-direct-connect-gateway.html)em *Referência de AWS CLI Comandos*.
### `delete-interconnect`
O código de exemplo a seguir mostra como usar `delete-interconnect`.
**AWS CLI**
**Para excluir uma interconexão**
O comando `delete-interconnect` a seguir exclui a interconexão especificada:
```
aws directconnect delete-interconnect --interconnect-id dxcon-fgktov66
```
Saída:
```
{
"interconnectState": "deleted"
}
```
+ Para obter detalhes da API, consulte [DeleteInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-interconnect.html)em *Referência de AWS CLI Comandos*.
### `delete-lag`
O código de exemplo a seguir mostra como usar `delete-lag`.
**AWS CLI**
**Para excluir um LAG**
O exemplo a seguir exclui o LAG especificado.
Comando:
```
aws directconnect delete-lag --lag-id dxlag-ffrhowd9
```
Saída:
```
{
"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 obter detalhes da API, consulte [DeleteLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-lag.html)em *Referência de AWS CLI Comandos*.
### `delete-virtual-interface`
O código de exemplo a seguir mostra como usar `delete-virtual-interface`.
**AWS CLI**
**Para excluir uma interface virtual**
O comando `delete-virtual-interface` a seguir exclui a interface virtual especificada:
```
aws directconnect delete-virtual-interface --virtual-interface-id dxvif-ffhhk74f
```
Saída:
```
{
"virtualInterfaceState": "deleting"
}
```
+ Para obter detalhes da API, consulte [DeleteVirtualInterface](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/delete-virtual-interface.html)em *Referência de AWS CLI Comandos*.
### `describe-connection-loa`
O código de exemplo a seguir mostra como usar `describe-connection-loa`.
**AWS CLI**
**Para descrever sua LOA-CFA para uma conexão usando Linux ou Mac OS X**
O exemplo a seguir descreve sua LOA-CFA para conexão `dxcon-fh6ayh1d`. O conteúdo da LOA-CFA é codificado em base64. Esse comando usa os parâmetros `--output` e `--query` para controlar a saída e extrair o conteúdo da estrutura `loaContent`. A parte final do comando decodifica o conteúdo usando o utilitário `base64` e envia a saída para um arquivo PDF.
```
aws directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf
```
**Para descrever sua LOA-CFA para uma conexão usando o Windows**
O exemplo anterior requer o uso do utilitário `base64` para decodificar a saída. Em um computador Windows, você pode usar `certutil` em vez disso. No exemplo a seguir, o primeiro comando descreve sua LOA-CFA para a conexão `dxcon-fh6ayh1d` e usa os parâmetros `--output` e `--query` e para controlar a saída e extrair o conteúdo da estrutura `loaContent` em um arquivo chamado `myLoaCfa.base64`. O segundo comando usa o utilitário `certutil` para decodificar o arquivo e enviar a saída a um arquivo PDF.
```
aws directconnect describe-connection-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64
```
```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Para obter mais informações sobre como controlar a saída da AWS CLI, consulte [Controlando a saída de comando da interface de linha de AWS comando no Guia](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) do *usuário da interface de linha de AWS comando*.
+ Para obter detalhes da API, consulte [DescribeConnectionLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connection-loa.html)em *Referência de AWS CLI Comandos*.
### `describe-connections-on-interconnect`
O código de exemplo a seguir mostra como usar `describe-connections-on-interconnect`.
**AWS CLI**
**Para listar conexões em uma interconexão**
O comando `describe-connections-on-interconnect` a seguir lista as conexões que foram provisionadas na interconexão fornecida:
```
aws directconnect describe-connections-on-interconnect --interconnect-id dxcon-fgktov66
```
Saída:
```
{
"connections": [
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeConnectionsOnInterconnect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections-on-interconnect.html)em *Referência de AWS CLI Comandos*.
### `describe-connections`
O código de exemplo a seguir mostra como usar `describe-connections`.
**AWS CLI**
**Para listar todas as conexões na região atual**
O comando `describe-connections` a seguir lista todas as conexões na região atual:
```
aws directconnect describe-connections
```
Saída:
```
{
"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 obter detalhes da API, consulte [DescribeConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-connections.html)em *Referência de AWS CLI Comandos*.
### `describe-direct-connect-gateway-association-proposals`
O código de exemplo a seguir mostra como usar `describe-direct-connect-gateway-association-proposals`.
**AWS CLI**
**Para descrever suas propostas de associação de gateway do Direct Connect**
O exemplo `describe-direct-connect-gateway-association-proposals` a seguir exibe detalhes sobre suas propostas de associação de gateway do Direct Connect.
```
aws directconnect describe-direct-connect-gateway-association-proposals
```
Saída:
```
{
"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 obter mais informações, consulte [Associar e desassociar gateways de trânsito](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-transit-gateways.html#associate-tgw-with-direct-connect-gateway) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [DescribeDirectConnectGatewayAssociationProposals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-association-proposals.html)em *Referência de AWS CLI Comandos*.
### `describe-direct-connect-gateway-associations`
O código de exemplo a seguir mostra como usar `describe-direct-connect-gateway-associations`.
**AWS CLI**
**Para descrever associações de gateway do Direct Connect**
O exemplo a seguir descreve todas as associações com o gateway do `5f294f92-bafb-4011-916d-9b0bexample` Direct Connect.
Comando:
```
aws directconnect describe-direct-connect-gateway-associations --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample
```
Saída:
```
{
"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 obter detalhes da API, consulte [DescribeDirectConnectGatewayAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-associations.html)em *Referência de AWS CLI Comandos*.
### `describe-direct-connect-gateway-attachments`
O código de exemplo a seguir mostra como usar `describe-direct-connect-gateway-attachments`.
**AWS CLI**
**Para descrever anexos de gateway do Direct Connect**
O exemplo a seguir descreve as interfaces virtuais conectadas ao gateway `5f294f92-bafb-4011-916d-9b0bexample` do Direct Connect.
Comando:
```
aws directconnect describe-direct-connect-gateway-attachments --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample
```
Saída:
```
{
"directConnectGatewayAttachments": [
{
"virtualInterfaceOwnerAccount": "123456789012",
"directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
"virtualInterfaceRegion": "us-east-2",
"attachmentState": "attaching",
"virtualInterfaceId": "dxvif-fg9zyabc"
}
],
"nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoibEhXdlNpUXF5RzhoL1JyUW52SlV2QT09IiwiYyI6Im5wQjFHQ0RyQUdRS3puNnNXcUlINCtkTTA4dTk3KzBiU0xtb05JQmlaczZ6NXRIYmk3c3VESUxFTTd6a2FzVHM0VTFwaGJkZGNxTytqWmQ3QzMzOGRQaTVrTThrOG1zelRsV3gyMWV3VTNFPSJ9"
}
```
+ Para obter detalhes da API, consulte [DescribeDirectConnectGatewayAttachments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateway-attachments.html)em *Referência de AWS CLI Comandos*.
### `describe-direct-connect-gateways`
O código de exemplo a seguir mostra como usar `describe-direct-connect-gateways`.
**AWS CLI**
**Para descrever seus gateways do Direct Connect**
O exemplo a seguir descreve todos os seus gateways do Direct Connect.
Comando:
```
aws directconnect describe-direct-connect-gateways
```
Saída:
```
{
"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 obter detalhes da API, consulte [DescribeDirectConnectGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-direct-connect-gateways.html)em *Referência de AWS CLI Comandos*.
### `describe-hosted-connections`
O código de exemplo a seguir mostra como usar `describe-hosted-connections`.
**AWS CLI**
**Para listar conexões em uma interconexão**
O exemplo a seguir lista as conexões que foram provisionadas na interconexão fornecida.
Comando:
```
aws directconnect describe-hosted-connections --connection-id dxcon-fgktov66
```
Saída:
```
{
"connections": [
{
"partnerName": "TIVIT",
"vlan": 101,
"ownerAccount": "123456789012",
"connectionId": "dxcon-ffzc51m1",
"connectionState": "ordering",
"bandwidth": "500Mbps",
"location": "TIVIT",
"connectionName": "mydcinterconnect",
"region": "sa-east-1"
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeHostedConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-hosted-connections.html)em *Referência de AWS CLI Comandos*.
### `describe-interconnect-loa`
O código de exemplo a seguir mostra como usar `describe-interconnect-loa`.
**AWS CLI**
**Para descrever sua LOA-CFA para uma interconexão usando Linux ou Mac OS X**
O exemplo a seguir descreve sua LOA-CFA para a interconexão `dxcon-fh6ayh1d`. O conteúdo da LOA-CFA é codificado em base64. Esse comando usa os parâmetros `--output` e `--query` para controlar a saída e extrair o conteúdo da estrutura `loaContent`. A parte final do comando decodifica o conteúdo usando o utilitário `base64` e envia a saída para um arquivo PDF.
```
aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf
```
**Para descrever sua LOA-CFA para uma interconexão usando o Windows**
O exemplo anterior requer o uso do utilitário `base64` para decodificar a saída. Em um computador Windows, você pode usar `certutil` em vez disso. No exemplo a seguir, o primeiro comando descreve sua LOA-CFA para a interconexão `dxcon-fh6ayh1d` e usa os parâmetros `--output` e `--query` e para controlar a saída e extrair o conteúdo da estrutura `loaContent` em um arquivo chamado `myLoaCfa.base64`. O segundo comando usa o utilitário `certutil` para decodificar o arquivo e enviar a saída a um arquivo PDF.
```
aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64
```
```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Para obter mais informações sobre como controlar a saída da AWS CLI, consulte [Controlando a saída de comando da interface de linha de AWS comando no Guia](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) do *usuário da interface de linha de AWS comando*.
+ Para obter detalhes da API, consulte [DescribeInterconnectLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnect-loa.html)em *Referência de AWS CLI Comandos*.
### `describe-interconnects`
O código de exemplo a seguir mostra como usar `describe-interconnects`.
**AWS CLI**
**Para listar as interconexões**
O `describe-interconnects` comando a seguir lista as interconexões pertencentes à sua AWS conta:
```
aws directconnect describe-interconnects
```
Saída:
```
{
"interconnects": [
{
"region": "sa-east-1",
"bandwidth": "1Gbps",
"location": "TIVIT",
"interconnectName": "1G Interconnect to AWS",
"interconnectId": "dxcon-fgktov66",
"interconnectState": "down"
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeInterconnects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-interconnects.html)em *Referência de AWS CLI Comandos*.
### `describe-lags`
O código de exemplo a seguir mostra como usar `describe-lags`.
**AWS CLI**
**Para descrever seu LAGs**
O comando a seguir descreve todos os seus LAGs para a região atual.
Comando:
```
aws directconnect describe-lags
```
Saída:
```
{
"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 obter detalhes da API, consulte [DescribeLags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-lags.html)em *Referência de AWS CLI Comandos*.
### `describe-loa`
O código de exemplo a seguir mostra como usar `describe-loa`.
**AWS CLI**
**Para descrever sua LOA-CFA para uma conexão usando Linux ou Mac OS X**
O exemplo a seguir descreve sua LOA-CFA para conexão `dxcon-fh6ayh1d`. O conteúdo da LOA-CFA é codificado em base64. Esse comando usa os parâmetros `--output` e `--query` para controlar a saída e extrair o conteúdo da estrutura `loaContent`. A parte final do comando decodifica o conteúdo usando o utilitário `base64` e envia a saída para um arquivo PDF.
```
aws directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf
```
**Para descrever sua LOA-CFA para uma conexão usando o Windows**
O exemplo anterior requer o uso do utilitário `base64` para decodificar a saída. Em um computador Windows, você pode usar `certutil` em vez disso. No exemplo a seguir, o primeiro comando descreve sua LOA-CFA para a conexão `dxcon-fh6ayh1d` e usa os parâmetros `--output` e `--query` e para controlar a saída e extrair o conteúdo da estrutura `loaContent` em um arquivo chamado `myLoaCfa.base64`. O segundo comando usa o utilitário `certutil` para decodificar o arquivo e enviar a saída a um arquivo PDF.
```
aws directconnect describe-loa --connection-id dxcon-fh6ayh1d --output text --query loa.loaContent > myLoaCfa.base64
```
```
certutil -decode myLoaCfa.base64 myLoaCfa.pdf
```
Para obter mais informações sobre como controlar a saída da AWS CLI, consulte [Controlando a saída de comando da interface de linha de AWS comando no Guia](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) do *usuário da interface de linha de AWS comando*.
+ Para obter detalhes da API, consulte [DescribeLoa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-loa.html)em *Referência de AWS CLI Comandos*.
### `describe-locations`
O código de exemplo a seguir mostra como usar `describe-locations`.
**AWS CLI**
**Para listar parceiros e locais do AWS Direct Connect**
O `describe-locations` comando a seguir lista os parceiros e locais do AWS Direct Connect na região atual:
```
aws directconnect describe-locations
```
Saída:
```
{
"locations": [
{
"locationName": "NAP do Brasil, Barueri, Sao Paulo",
"locationCode": "TNDB"
},
{
"locationName": "Tivit - Site Transamerica (Sao Paulo)",
"locationCode": "TIVIT"
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeLocations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-locations.html)em *Referência de AWS CLI Comandos*.
### `describe-tags`
O código de exemplo a seguir mostra como usar `describe-tags`.
**AWS CLI**
**Para descrever tags para seus recursos do AWS Direct Connect**
O comando a seguir descreve as tags da conexão `dxcon-abcabc12`.
Comando:
```
aws directconnect describe-tags --resource-arns arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12
```
Saída:
```
{
"resourceTags": [
{
"resourceArn": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12",
"tags": [
{
"value": "VAConnection",
"key": "Name"
}
]
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-tags.html)em *Referência de AWS CLI Comandos*.
### `describe-virtual-gateways`
O código de exemplo a seguir mostra como usar `describe-virtual-gateways`.
**AWS CLI**
**Para listar gateways privados virtuais**
O `describe-virtual-gateways` comando a seguir lista os gateways privados virtuais pertencentes à sua AWS conta:
```
aws directconnect describe-virtual-gateways
```
Saída:
```
{
"virtualGateways": [
{
"virtualGatewayId": "vgw-aba37db6",
"virtualGatewayState": "available"
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeVirtualGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-gateways.html)em *Referência de AWS CLI Comandos*.
### `describe-virtual-interfaces`
O código de exemplo a seguir mostra como usar `describe-virtual-interfaces`.
**AWS CLI**
**Para listar todas as interfaces virtuais**
O `describe-virtual-interfaces` comando a seguir lista as informações sobre todas as interfaces virtuais associadas à sua AWS conta:
```
aws directconnect describe-virtual-interfaces --connection-id dxcon-ffjrkx17
```
Saída:
```
{
"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 obter detalhes da API, consulte [DescribeVirtualInterfaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/describe-virtual-interfaces.html)em *Referência de AWS CLI Comandos*.
### `disassociate-connection-from-lag`
O código de exemplo a seguir mostra como usar `disassociate-connection-from-lag`.
**AWS CLI**
**Como desassociar uma conexão de um LAG**
O exemplo a seguir dissocia a conexão especificada do LAG especificado.
Comando:
```
aws directconnect disassociate-connection-from-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm
```
Saída:
```
{
"ownerAccount": "123456789012",
"connectionId": "dxcon-fg9607vm",
"connectionState": "requested",
"bandwidth": "1Gbps",
"location": "EqDC2",
"connectionName": "Con2ForLag",
"region": "us-east-1"
}
```
+ Para obter detalhes da API, consulte [DisassociateConnectionFromLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/disassociate-connection-from-lag.html)em *Referência de AWS CLI Comandos*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Para adicionar uma tag a um recurso do AWS Direct Connect**
O comando a seguir adiciona uma tag com uma chave de `Name` e um valor de `VAConnection` à instância `dxcon-abcabc12`. Se o comando for bem-sucedido, nenhuma saída será retornada.
Comando:
```
aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tags "key=Name,value=VAConnection"
```
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/tag-resource.html)em *Referência de AWS CLI Comandos*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover uma tag de um recurso do AWS Direct Connect**
O comando a seguir remove a tag com a chave `Name` da conexão `dxcon-abcabc12`. Se o comando for bem-sucedido, nenhuma saída será retornada.
Comando:
```
aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tag-keys Name
```
+ Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/untag-resource.html)em *Referência de AWS CLI Comandos*.
### `update-direct-connect-gateway-association`
O código de exemplo a seguir mostra como usar `update-direct-connect-gateway-association`.
**AWS CLI**
**Para atualizar os atributos especificados da associação do gateway do Direct Connect**
O exemplo `update-direct-connect-gateway-association` a seguir adiciona o bloco CIDR especificado a uma associação de gateway do 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
```
Saída:
```
{
"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 obter mais informações, consulte [Trabalhar com gateways do Direct Connect](https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-gateways.html) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [UpdateDirectConnectGatewayAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-direct-connect-gateway-association.html)em *Referência de AWS CLI Comandos*.
### `update-lag`
O código de exemplo a seguir mostra como usar `update-lag`.
**AWS CLI**
**Para atualizar um LAG**
O exemplo a seguir altera o nome do LAG específico.
Comando:
```
aws directconnect update-lag --lag-id dxlag-ffjhj9lx --lag-name 2ConnLag
```
Saída:
```
{
"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 obter detalhes da API, consulte [UpdateLag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-lag.html)em *Referência de AWS CLI Comandos*.
### `update-virtual-interface-attributes`
O código de exemplo a seguir mostra como usar `update-virtual-interface-attributes`.
**AWS CLI**
**Para atualizar a MTU de uma interface virtual**
O exemplo `update-virtual-interface-attributes` a seguir atualiza a MTU da interface virtual especificada.
```
aws directconnect update-virtual-interface-attributes \
--virtual-interface-id dxvif-fEXAMPLE \
--mtu 1500
```
Saída:
```
{
"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 obter mais informações, consulte [Configurar a MTU de rede para interfaces virtuais privadas ou interfaces virtuais de trânsito](https://docs.aws.amazon.com/directconnect/latest/UserGuide/set-jumbo-frames-vif.html) no *Guia do usuário do AWS Direct Connect*.
+ Para obter detalhes da API, consulte [UpdateVirtualInterfaceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/directconnect/update-virtual-interface-attributes.html)em *Referência de AWS CLI Comandos*.