View a markdown version of this page

Gunakan Direct Connect CLI - AWS Direct Connect
Langkah 1: Buat koneksiLangkah 2: Unduh LOA-CFALangkah 3: Buat antarmuka virtual dan dapatkan konfigurasi router

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Gunakan Direct Connect CLI

Anda dapat menggunakan AWS CLI untuk membuat dan bekerja dengan Direct Connect sumber daya.

Contoh berikut menggunakan AWS CLI perintah untuk membuat Direct Connect koneksi. Anda juga dapat mengunduh Letter of Authorization and Connecting Facility Assignment (LOA-CFA) atau menyediakan antarmuka virtual pribadi atau publik.

Sebelum memulai, pastikan Anda telah menginstal dan mengonfigurasi AWS CLI. Untuk informasi selengkapnya, silakan lihat Panduan Pengguna AWS Command Line Interface.

Langkah 1: Buat koneksi

Langkah pertama adalah mengirimkan permintaan koneksi. Pastikan Anda mengetahui kecepatan port yang Anda butuhkan dan Direct Connect lokasi. Untuk informasi selengkapnya, lihat Koneksi khusus dan dihosting.

Untuk membuat permintaan koneksi

  1. Jelaskan Direct Connect lokasi untuk Wilayah Anda saat ini. Dalam output yang dihasilkan, perhatikan kode lokasi untuk lokasi di mana Anda ingin membuat koneksi.

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

  2. Buat koneksi dan tentukan nama, kecepatan port, dan kode lokasi. Dalam output yang dihasilkan, perhatikan ID koneksi. Anda memerlukan ID untuk mendapatkan LOA-CFA di langkah berikutnya.

    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"
}

Langkah 2: Unduh LOA-CFA

Setelah Anda meminta koneksi, Anda bisa mendapatkan describe-loa perintah LOA-CFA menggunakan. Output-nya dikodekan base64. Anda harus mengekstraksi konten LOA yang relevan, memecahkan kode, dan membuat file PDF.

Untuk mendapatkan LOA-CFA menggunakan Linux atau macOS

Dalam contoh ini, bagian terakhir dari perintah mendekode konten menggunakan utilitas base64, dan mengirimkan output ke file PDF.

aws directconnect describe-loa --connection-id dxcon-fg31dyv6 --output text --query loaContent|base64 --decode > myLoaCfa.pdf
Untuk mendapatkan LOA-CFA menggunakan Windows

Dalam contoh ini, output diekstraksi ke file bernama myLoaCfa.base64. Perintah kedua menggunakan utilitas certutil untuk memecahkan kode file dan mengirim output ke file PDF.

aws directconneawsct describe-loa --connection-id dxcon-fg31dyv6 --output text --query loaContent > myLoaCfa.base64
certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Setelah Anda mengunduh LOA-CFA, kirimkan ke penyedia jaringan atau penyedia colocation Anda.

Langkah 3: Buat antarmuka virtual dan dapatkan konfigurasi router

Setelah Anda memesan Direct Connect koneksi, Anda harus membuat antarmuka virtual untuk mulai menggunakannya. Anda dapat membuat antarmuka virtual privat untuk terhubung ke VPC Anda. Atau, Anda dapat membuat antarmuka virtual publik untuk terhubung ke AWS layanan yang tidak ada dalam VPC. Anda dapat membuat antarmuka virtual yang mendukung lau lintas IPv4 atau IPv6.

Sebelum memulai, pastikan Anda telah membaca prasyarat di Prasyarat untuk antarmuka virtual.

Saat Anda membuat antarmuka virtual menggunakan AWS CLI, output mencakup informasi konfigurasi router generik. Untuk membuat konfigurasi router yang khusus untuk perangkat Anda, gunakan Direct Connect konsol. Untuk informasi selengkapnya, lihat Mengunduh file konfigurasi router.

Untuk membuat antarmuka virtual privat

  1. Dapatkan ID virtual private gateway (vgw-xxxxxxxx) yang terpasang pada VPC Anda. Anda memerlukan ID untuk membuat antarmuka virtual pada langkah berikutnya.

    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. Buat antarmuka virtual privat. Anda harus menentukan nama, VLAN ID, dan BGP Autonomous System Number (ASN).

    Untuk lalu lintas IPv4, Anda perlu alamat IPv4 privat untuk setiap akhir sesi peering BGP. Anda dapat menentukan alamat IPv4 Anda sendiri, atau Anda dapat membiarkan Amazon menghasilkan alamat untuk Anda. Pada contoh berikut, alamat IPv4 dihasilkan untuk Anda.

    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"
}

    Untuk membuat antarmuka virtual privat yang mendukung lalu lintas IPv6, gunakan perintah yang sama seperti di atas dan tentukan parameter ipv6 untuk addressFamily. Anda tidak dapat menentukan alamat IPv6 Anda sendiri untuk sesi peering BGP; Amazon mengalokasikan alamat IPv6 Anda.

  3. Untuk melihat informasi konfigurasi router dalam format XML, uraikan antarmuka virtual yang Anda buat. Menggunakan parameter --query untuk mengekstraksi informasi customerRouterConfig, dan parameter --output untuk mengatur teks menjadi garis berbatas tab.

    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>
Untuk membuat antarmuka virtual publik

  1. Untuk membuat antarmuka virtual publik, Anda harus menentukan nama, VLAN ID, dan Autonomous System Number (ASN) BGP.

    Untuk lalu lintas IPv4, Anda juga harus menentukan alamat IPv4 publik untuk setiap akhir sesi peering BGP, dan rute IPv4 publik yang akan Anda iklankan beriklan melalui BGP. Contoh berikut membuat antarmuka virtual publik untuk lalu lintas 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"
}

    Untuk membuat antarmuka virtual publik yang mendukung lalu lintas IPv6, Anda dapat menentukan rute IPv6 yang akan Anda iklankan melalui BGP. Anda tidak dapat menentukan alamat IPv6 untuk sesi peering; Amazon mengalokasikan alamat IPv6 untuk Anda. Contoh berikut membuat antarmuka virtual publik untuk lalu lintas 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. Untuk melihat informasi konfigurasi router dalam format XML, uraikan antarmuka virtual yang Anda buat. Menggunakan parameter --query untuk mengekstraksi informasi customerRouterConfig, dan parameter --output untuk mengatur teks menjadi garis berbatas tab.

    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>