View a markdown version of this page

Use o comando Direct Connect CLI - AWS Direct Connect
Etapa 1: Criar uma conexãoEtapa 2: Faça o download do LOA-CFAEtapa 3: Criar uma interface virtual e obter a configuração do roteador

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

Use o comando Direct Connect CLI

Você pode usar o AWS CLI para criar e trabalhar com Direct Connect recursos.

O exemplo a seguir usa os AWS CLI comandos para criar uma Direct Connect conexão. Você também pode baixar a Carta de Autorização e Atribuição de Facilidade de Conexão (LOA-CFA) ou provisionar uma interface virtual pública ou privada.

Antes de começar, certifique-se de que você tenha instalado e configurado a AWS CLI. Para obter mais informações, consulte o Guia do usuário do AWS Command Line Interface.

Etapa 1: Criar uma conexão

A primeira etapa é enviar uma solicitação de conexão. Certifique-se de saber a velocidade da porta necessária e a Direct Connect localização. Para obter mais informações, consulte Conexões dedicadas e hospedadas.

Para criar uma solicitação de conexão

  1. Descreva os Direct Connect locais da sua região atual. Na saída retornada, anote o código do local no qual você deseja estabelecer a conexão.

    aws directconnect describe-locations
    {
    "locations": [
        {
            "locationName": "City 1, United States",
            "locationCode": "Example Location 1"
        },
        {
            "locationName": "City 2, United States",
            "locationCode": "Example location"
        }
    ]
}

  2. Crie a conexão e especifique um nome, a velocidade da porta e o código do local. Na saída retornada, anote a ID da conexão. Você precisa do ID para obtê-lo LOA-CFA na próxima etapa.

    aws directconnect create-connection --location Example location --bandwidth 1Gbps --connection-name "Connection to AWS"
    {
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-EXAMPLE",
    "connectionState": "requested",
    "bandwidth": "1Gbps",
    "location": "Example location",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

Etapa 2: Faça o download do LOA-CFA

Depois de solicitar uma conexão, você pode obtê-la LOA-CFA usando o describe-loa comando. A saída é codificada em base64. Você deve extrair o conteúdo LOA relevante, decodificá-lo e criar um arquivo PDF.

Para obter o LOA-CFA usando Linux ou macOS

Neste exemplo, 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-fg31dyv6 --output text --query loaContent|base64 --decode > myLoaCfa.pdf
Para obter o LOA-CFA uso do Windows

Neste exemplo, a saída é extraída para 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 directconneawsct describe-loa --connection-id dxcon-fg31dyv6 --output text --query loaContent > myLoaCfa.base64
certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Depois de fazer o download do LOA-CFA, envie-o para seu provedor de rede ou provedor de colocation.

Etapa 3: Criar uma interface virtual e obter a configuração do roteador

Depois de fazer um pedido de Direct Connect conexão, você deve criar uma interface virtual para começar a usá-la. Crie uma interface virtual privada para se conectar à VPC. Ou você pode criar uma interface virtual pública para se conectar a AWS serviços que não estão em uma VPC. Você pode criar uma interface virtual compatível com tráfego IPv4 ou IPv6.

Antes de começar, certifique-se de que você tenha lido os pré-requisitos em Pré-requisitos para interfaces virtuais.

Quando você cria uma interface virtual usando o AWS CLI, a saída inclui informações genéricas de configuração do roteador. Para criar uma configuração de roteador específica para seu dispositivo, use o Direct Connect console. Para obter mais informações, consulte Baixar arquivo de configuração do roteador.

Para criar uma interface virtual privada

  1. Obtenha a ID do gateway privado virtual (vgw-xxxxxxxx) conectado à VPC. Você precisará da ID para criar a interface virtual na próxima etapa.

    aws ec2 describe-vpn-gateways
    {
    "VpnGateways": [
        {
            "State": "available", 
            "Tags": [
                {
                    "Value": "DX_VGW", 
                    "Key": "Name"
                }
            ], 
            "Type": "ipsec.1", 
            "VpnGatewayId": "vgw-ebaa27db", 
            "VpcAttachments": [
                {
                    "State": "attached", 
                    "VpcId": "vpc-24f33d4d"
                }
            ]
        }
    ]
}

  2. Crie uma interface virtual privada. Você deve especificar um nome, uma ID de VLAN e um Autonomous System Number (ASN - Número de sistema autônomo) BGP.

    Para tráfego IPv4, você precisa de endereços IPv4 privados para cada fim de sessão de mesmo nível BGP. Você pode especificar os próprios endereços IPv4 ou permitir que a Amazon gere endereços para você. No exemplo a seguir, os endereços IPv4 são gerados para você.

    aws directconnect create-private-virtual-interface --connection-id dxcon-fg31dyv6 --new-private-virtual-interface virtualInterfaceName=PrivateVirtualInterface,vlan=101,asn=65000,virtualGatewayId=vgw-ebaa27db,addressFamily=ipv4
    {
    "virtualInterfaceState": "pending",
    "asn": 65000,
    "vlan": 101,
    "customerAddress": "192.168.1.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "addressFamily": "ipv4", 
    "virtualGatewayId": "vgw-ebaa27db",
    "virtualInterfaceId": "dxvif-ffhhk74f",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [],
    "location": "Example location",
    "bgpPeers": [
        {
            "bgpStatus": "down", 
            "customerAddress": "192.168.1.2/30", 
            "addressFamily": "ipv4", 
            "authKey": "asdf34example", 
            "bgpPeerState": "pending", 
            "amazonAddress": "192.168.1.1/30", 
            "asn": 65000
        }
    "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 criar uma interface virtual privada compatível com tráfego IPv6, use o mesmo comando acima e especifique ipv6 para o parâmetro addressFamily. Você não pode especificar os próprios endereços IPv6 para a sessão de mesmo nível BGP; a Amazon aloca endereços IPv6 para você.

  3. Para visualizar as informações de configuração do roteador em formato XML, descreva a interface virtual criada por você. Use o parâmetro --query para extrair as informações customerRouterConfig e o parâmetro --output para organizar o texto em linhas delimitadas por tabulações.

    aws directconnect describe-virtual-interfaces --virtual-interface-id dxvif-ffhhk74f --query virtualInterfaces[*].customerRouterConfig --output text
    <?xml version="1.0" encoding="UTF-8"?>
<logical_connection id="dxvif-ffhhk74f">
  <vlan>101</vlan>
  <customer_address>192.168.1.2/30</customer_address>
  <amazon_address>192.168.1.1/30</amazon_address>
  <bgp_asn>65000</bgp_asn>
  <bgp_auth_key>asdf34example</bgp_auth_key>
  <amazon_bgp_asn>7224</amazon_bgp_asn>
  <connection_type>private</connection_type>
</logical_connection>
Para criar uma interface virtual pública

  1. Para criar uma interface virtual pública, você deve especificar um nome, uma ID VLAN e um ASN BGP.

    Para tráfego IPv4, você também deve especificar endereços IPv4 públicos para cada fim de sessão de mesmo nível BGP e rotas IPv4 que anunciará via BGP. O exemplo a seguir cria uma interface virtual pública para tráfego IPv4.

    aws directconnect create-public-virtual-interface --connection-id dxcon-fg31dyv6 --new-public-virtual-interface virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,addressFamily=ipv4,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}]
    {
    "virtualInterfaceState": "verifying",
    "asn": 65000,
    "vlan": 2000,
    "customerAddress": "203.0.113.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "addressFamily": "ipv4",
    "virtualGatewayId": "",
    "virtualInterfaceId": "dxvif-fgh0hcrk",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [
        {
            "cidr": "203.0.113.0/30"
        },
        {
            "cidr": "203.0.113.4/30"
        }
    ],
    "location": "Example location",
    "bgpPeers": [
        {
            "bgpStatus": "down", 
            "customerAddress": "203.0.113.2/30", 
            "addressFamily": "ipv4", 
            "authKey": "asdf34example", 
            "bgpPeerState": "verifying", 
            "amazonAddress": "203.0.113.1/30", 
            "asn": 65000
        }
    ],
    "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 criar uma interface virtual pública compatível com tráfego IPv6, você pode especificar rotas IPv6 que anunciará via BGP. Você não pode especificar endereços IPv6 para a sessão de mesmo nível; a Amazon aloca endereços IPv6 para você. O exemplo a seguir cria uma interface virtual pública para tráfego IPv6.

    aws directconnect create-public-virtual-interface --connection-id dxcon-fg31dyv6 --new-public-virtual-interface virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,addressFamily=ipv6,routeFilterPrefixes=[{cidr=2001:db8:64ce:ba00::/64},{cidr=2001:db8:64ce:ba01::/64}]

  2. Para visualizar as informações de configuração do roteador em formato XML, descreva a interface virtual criada por você. Use o parâmetro --query para extrair as informações customerRouterConfig e o parâmetro --output para organizar o texto em linhas delimitadas por tabulações.

    aws directconnect describe-virtual-interfaces --virtual-interface-id dxvif-fgh0hcrk --query virtualInterfaces[*].customerRouterConfig --output text

    <?xml version="1.0" encoding="UTF-8"?>
<logical_connection id="dxvif-fgh0hcrk">
  <vlan>2000</vlan>
  <customer_address>203.0.113.2/30</customer_address>
  <amazon_address>203.0.113.1/30</amazon_address>
  <bgp_asn>65000</bgp_asn>
  <bgp_auth_key>asdf34example</bgp_auth_key>
  <amazon_bgp_asn>7224</amazon_bgp_asn>
  <connection_type>public</connection_type>
</logical_connection>