Exemplos de AWS Direct Connect usando a 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 com o AWS 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 funções 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.

Tópicos

Ações

Ações

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 no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte AcceptDirectConnectGatewayAssociationProposal na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte AllocateConnectionOnInterconnect na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte AllocateHostedConnection na Referência de comandos da AWS CLI.

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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n  <logical_connection id=\"dxvif-fgy8orxu\">\n  <vlan>1000</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
    "amazonAddress": "192.168.1.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "PrivateVirtualInterface"
}

Para ver detalhes da API, consulte AllocatePrivateVirtualInterface na Referência de comandos da AWS CLI.

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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg9xo9vp\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
    "amazonAddress": "203.0.113.1/30",
    "virtualInterfaceType": "public",
    "virtualInterfaceName": "PublicVirtualInterface"
}

Para ver detalhes da API, consulte AllocatePublicVirtualInterface na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar allocate-transit-virtual-interface.

AWS CLI

Como provisionar uma interface virtual em trânsito para pertencer à conta da AWS 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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fEXAMPLE\">\n  <vlan>126</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65110</bgp_asn>\n  <bgp_auth_key>0xzxgA9YoW9h58u8SEXAMPLE</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>transit</connection_type>\n</logical_connection>\n",
        "mtu": 1500,
        "jumboFrameCapable": true,
        "virtualGatewayId": "",
        "directConnectGatewayId": "",
        "routeFilterPrefixes": [],
        "bgpPeers": [
            {
                "bgpPeerId": "dxpeer-fEXAMPLE",
                "asn": 65110,
                "authKey": "0xzxgA9YoW9h58u8EXAMPLE",
                "addressFamily": "ipv4",
                "amazonAddress": "192.168.1.1/30",
                "customerAddress": "192.168.1.2/30",
                "bgpPeerState": "pending",
                "bgpStatus": "down",
                "awsDeviceV2": "loc1-26wz6vEXAMPLE"
            }
        ],
        "region": "sa-east-1",
        "awsDeviceV2": "loc1-26wz6vEXAMPLE",
        "tags": [
            {
                "key": "Tag",
                "value": "Example"
            }
        ]
    }
}

Para obter informações, consulte Criar uma interface virtual de trânsito hospedada no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte AllocateTransitVirtualInterface na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte AssociateConnectionWithLag na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte AssociateHostedConnection na Referência de comandos da AWS CLI.

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 do 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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgputw0j\">\n  <vlan>123</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0x123pK5_VBqv.UQ3kJ4123_</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
  "amazonAddress": "169.254.255.1/30",
  "virtualInterfaceType": "private",
  "virtualInterfaceName": "VIF1A"
}

Para ver detalhes da API, consulte AssociateVirtualInterface na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte ConfirmConnection na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte ConfirmPrivateVirtualInterface na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte ConfirmPublicVirtualInterface na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte ConfirmTransitVirtualInterface na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar create-bgp-peer.

AWS CLI

Para criar uma sessão de emparelhamento BGP IPv6

O exemplo a seguir cria uma sessão de emparelhamento BGP IPv6 em uma interface virtual privada dxvif-fg1vuj3d. Os endereços IPv6 de mesmo nível 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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg1vuj3d\">\n  <vlan>125</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0xC_ukbCerl6EYA0uexample</bgp_auth_key>\n  <ipv6_customer_address>2001:db8:1100:2f0:0:1:9cb4:4216/125</ipv6_customer_address>\n  <ipv6_amazon_address>2001:db8:1100:2f0:0:1:9cb4:4211/125</ipv6_amazon_address>\n  <ipv6_bgp_asn>64600</ipv6_bgp_asn>\n  <ipv6_bgp_auth_key>0xS27kAIU_VHPjjAexample</ipv6_bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
      "amazonAddress": "169.254.255.1/30",
      "virtualInterfaceType": "private",
      "virtualInterfaceName": "Test"
  }
}

Para ver detalhes da API, consulte CreateBgpPeer na Referência de comandos da AWS CLI.

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 comando create-connection 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 ver detalhes da API, consulte CreateConnection na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte CreateDirectConnectGatewayAssociationProposal na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte CreateDirectConnectGatewayAssociation na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte CreateDirectConnectGateway na Referência de comandos da AWS CLI.

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 a AWS

O comando create-interconnect a seguir cria uma nova interconexão entre uma rede de 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 ver detalhes da API, consulte CreateInterconnect na Referência de comandos da AWS CLI.

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 com o 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 ver detalhes da API, consulte CreateLag na Referência de comandos da AWS CLI.

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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-ffhhk74f\">\n  <vlan>101</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
    "amazonAddress": "192.168.1.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "PrivateVirtualInterface"
}

Para ver detalhes da API, consulte CreatePrivateVirtualInterface na Referência de comandos da AWS CLI.

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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgh0hcrk\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
    "amazonAddress": "203.0.113.1/30",
    "virtualInterfaceType": "public",
    "virtualInterfaceName": "PublicVirtualInterface"
}

Para ver detalhes da API, consulte CreatePublicVirtualInterface na Referência de comandos da AWS CLI.

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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fEXAMPLE\">\n  <vlan>126</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65110</bgp_asn>\n  <bgp_auth_key>0xzxgA9YoW9h58u8SvOmXRTw</bgp_auth_key>\n  <amazon_bgp_asn>4200000000</amazon_bgp_asn>\n  <connection_type>transit</connection_type>\n</logical_connection>\n",
        "mtu": 1500,
        "jumboFrameCapable": true,
        "virtualGatewayId": "",
        "directConnectGatewayId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE",
        "routeFilterPrefixes": [],
        "bgpPeers": [
            {
                "bgpPeerId": "dxpeer-EXAMPLE",
                "asn": 65110,
                "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
                "addressFamily": "ipv4",
                "amazonAddress": "192.168.1.1/30",
                "customerAddress": "192.168.1.2/30",
                "bgpPeerState": "pending",
                "bgpStatus": "down",
                "awsDeviceV2": "loc1-26wz6vEXAMPLE"
            }
        ],
        "region": "sa-east-1",
        "awsDeviceV2": "loc1-26wz6vEXAMPLE",
        "tags": [
            {
                "key": "Tag",
                "value": "Example"
            }
        ]
    }
}

Para obter informações, consulte Criar uma interface virtual de gateway do Direct Connect no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte CreateTransitVirtualInterface na Referência de comandos da AWS CLI.

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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg1vuj3d\">\n  <vlan>125</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0xC_ukbCerl6EYA0example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
      "amazonAddress": "169.254.255.1/30",
      "virtualInterfaceType": "private",
      "virtualInterfaceName": "Test"
  }
}

Para ver detalhes da API, consulte DeleteBgpPeer na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DeleteConnection na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte DeleteDirectConnectGatewayAssociation na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DeleteDirectConnectGateway na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DeleteInterconnect na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DeleteLag na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DeleteVirtualInterface na Referência de comandos da AWS CLI.

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 mais informações sobre controlar a saída da AWS CLI, consulte Controlar a saída do comando da AWS Command Line Interface no Guia do usuário da AWS Command Line Interface.

Para ver detalhes da API, consulte DescribeConnectionLoa na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DescribeConnectionsOnInterconnect na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DescribeConnections na Referência de comandos da AWS CLI.

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 no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte DescribeDirectConnectGatewayAssociationProposals na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DescribeDirectConnectGatewayAssociations na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DescribeDirectConnectGatewayAttachments na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DescribeDirectConnectGateways na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DescribeHostedConnections na Referência de comandos da AWS CLI.

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 mais informações sobre controlar a saída da AWS CLI, consulte Controlar a saída do comando da AWS Command Line Interface no Guia do usuário da AWS Command Line Interface.

Para ver detalhes da API, consulte DescribeInterconnectLoa na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-interconnects.

AWS CLI

Para listar as interconexões

O comando describe-interconnects a seguir lista as interconexões pertencentes à sua conta da AWS:


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 ver detalhes da API, consulte DescribeInterconnects na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-lags.

AWS CLI

Para descrever seus LAGs

O comando a seguir descreve todos os seus LAGs da 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 ver detalhes da API, consulte DescribeLags na Referência de comandos da AWS CLI.

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


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


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


certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Para mais informações sobre controlar a saída da AWS CLI, consulte Controlar a saída do comando da AWS Command Line Interface no Guia do usuário da AWS Command Line Interface.

Para ver detalhes da API, consulte DescribeLoa na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-locations.

AWS CLI

Para listar parceiros e locais do AWS Direct Connect

O comando describe-locations 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 ver detalhes da API, consulte DescribeLocations na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DescribeTags na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-virtual-gateways.

AWS CLI

Para listar gateways privados virtuais

O comando describe-virtual-gateways a seguir lista gateways privados virtuais pertencentes à sua conta da AWS:


aws directconnect describe-virtual-gateways

Saída:


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

Para ver detalhes da API, consulte DescribeVirtualGateways na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-virtual-interfaces.

AWS CLI

Para listar todas as interfaces virtuais

O comando describe-virtual-interfaces a seguir lista as informações sobre todas as interfaces virtuais associadas à sua conta da AWS:


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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-ffhhk74f\">\n  <vlan>101</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
            "amazonAddress": "192.168.1.1/30",
            "virtualInterfaceType": "private",
            "virtualInterfaceName": "PrivateVirtualInterface"
        },
        {
            "virtualInterfaceState": "verifying",
            "asn": 65000,
            "vlan": 2000,
            "customerAddress": "203.0.113.2/30",
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffjrkx17",
            "virtualGatewayId": "",
            "virtualInterfaceId": "dxvif-fgh0hcrk",
            "authKey": "asdf34example",
            "routeFilterPrefixes": [
                {
                    "cidr": "203.0.113.4/30"
                },
                {
                    "cidr": "203.0.113.0/30"
                }
            ],
            "location": "TIVIT",
            "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgh0hcrk\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
            "amazonAddress": "203.0.113.1/30",
            "virtualInterfaceType": "public",
            "virtualInterfaceName": "PublicVirtualInterface"
        }
    ]
}

Para ver detalhes da API, consulte DescribeVirtualInterfaces na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte DisassociateConnectionFromLag na Referência de comandos da AWS CLI.

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 na Referência de comandos da AWS CLI.

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 sobre a API, consulte UntagResource na AWS CLI Command Reference.

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 no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte UpdateDirectConnectGatewayAssociation na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte UpdateLag na Referência de comandos da AWS CLI.

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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fEXAMPLE\">\n  <vlan>125</vlan>\n  <customer_address>169.254.248.2/30</customer_address>\n  <amazon_address>169.254.248.1/30</amazon_address>\n  <bgp_asn>650001</bgp_asn>\n  <bgp_auth_key>0xzxgA9YoW9h58u8SEXAMPLE</bgp_auth_key>\n  <amazon_bgp_asn>64512</amazon_bgp_asn>\n  <connection_type>transit</connection_type>\n</logical_connection>\n",
    "mtu": 1500,
    "jumboFrameCapable": true,
    "virtualGatewayId": "",
    "directConnectGatewayId": "879b76a1-403d-4700-8b53-4a56ed85436e",
    "routeFilterPrefixes": [],
    "bgpPeers": [
        {
            "bgpPeerId": "dxpeer-fEXAMPLE",
            "asn": 650001,
            "authKey": "0xzxgA9YoW9h58u8SEXAMPLE",
            "addressFamily": "ipv4",
            "amazonAddress": "169.254.248.1/30",
            "customerAddress": "169.254.248.2/30",
            "bgpPeerState": "available",
            "bgpStatus": "down",
            "awsDeviceV2": "loc1-26wz6vEXAMPLE"
        }
    ],
    "region": "sa-east-1",
    "awsDeviceV2": "loc1-26wz6vEXAMPLE",
    "tags": []
}

Para obter mais informações, consulte Configurar a MTU de rede para interfaces virtuais privadas ou interfaces virtuais de trânsito no Guia do usuário do AWS Direct Connect.

Para ver detalhes da API, consulte UpdateVirtualInterfaceAttributes na Referência de comandos da AWS CLI.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Device Farm

AWS Directory Service