AWS Direct Connect 사용 예제 AWS CLI - AWS Command Line Interface
작업

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS Direct Connect 사용 예제 AWS CLI

다음 코드 예제에서는 AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS Direct Connect.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 accept-direct-connect-gateway-association-proposal을 사용하는 방법을 보여 줍니다.

AWS CLI

게이트웨이 연결 제안을 수락하려면

다음은 지정된 제안을 accept-direct-connect-gateway-association-proposal 수락합니다.

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

자세한 내용은 AWS Direct Connect 사용 설명서의 Transit Gateway 연결 제안 수락 또는 거부를 참조하세요.

다음 코드 예시에서는 allocate-connection-on-interconnect을 사용하는 방법을 보여 줍니다.

AWS CLI

인터커넥트에서 호스팅 연결을 생성하려면

다음 allocate-connection-on-interconnect 명령은 상호 연결에 호스팅 연결을 생성합니다.

aws directconnect allocate-connection-on-interconnect --bandwidth 500Mbps --connection-name mydcinterconnect --owner-account 123456789012 --interconnect-id dxcon-fgktov66 --vlan 101

출력:

{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}

다음 코드 예시에서는 allocate-hosted-connection을 사용하는 방법을 보여 줍니다.

AWS CLI

상호 연결에서 호스팅 연결을 생성하려면

다음 allocate-hosted-connection 예제에서는 지정된 인터커넥트에 호스팅 연결을 생성합니다.

aws directconnect allocate-hosted-connection \
    --bandwidth 500Mbps \
    --connection-name mydcinterconnect \
    --owner-account 123456789012
    -connection-id dxcon-fgktov66
    -vlan 101

출력:

{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}

다음 코드 예시에서는 allocate-private-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

프라이빗 가상 인터페이스를 프로비저닝하려면

다음 allocate-private-virtual-interface 명령은 다른 고객이 소유할 프라이빗 가상 인터페이스를 프로비저닝합니다.

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

출력:

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

다음 코드 예시에서는 allocate-public-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

퍼블릭 가상 인터페이스를 프로비저닝하려면

다음 allocate-public-virtual-interface 명령은 다른 고객이 소유할 퍼블릭 가상 인터페이스를 프로비저닝합니다.

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

출력:

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

다음 코드 예시에서는 allocate-transit-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

지정된 AWS 계정에서 소유할 전송 가상 인터페이스를 프로비저닝하려면

다음 allocate-transit-virtual-interface 예제에서는 지정된 계정에 대한 전송 가상 인터페이스를 프로비저닝합니다.

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

출력:

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

자세한 내용은 AWS Direct Connect 사용 설명서의 호스팅 전송 가상 인터페이스 생성을 참조하세요.

다음 코드 예시에서는 associate-connection-with-lag을 사용하는 방법을 보여 줍니다.

AWS CLI

에 연결을 연결하려면 LAG

다음 예제에서는 지정된 연결을 지정된 와 연결합니다LAG.

명령:

aws directconnect associate-connection-with-lag --lag-id dxlag-fhccu14t --connection-id dxcon-fg9607vm

출력:

{
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "lagId": "dxlag-fhccu14t",
  "connectionState": "requested",
  "bandwidth": "1Gbps",
  "location": "EqDC2",
  "connectionName": "Con2ForLag",
  "region": "us-east-1"
}

다음 코드 예시에서는 associate-hosted-connection을 사용하는 방법을 보여 줍니다.

AWS CLI

호스팅 연결을 에 연결하려면 LAG

다음 예제에서는 지정된 호스팅 연결을 지정된 와 연결합니다LAG.

명령:

aws directconnect associate-hosted-connection --parent-connection-id dxlag-fhccu14t --connection-id dxcon-fg9607vm

출력:

{
  "partnerName": "TIVIT",
  "vlan": 101,
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "lagId": "dxlag-fhccu14t",
  "connectionState": "ordering",
  "bandwidth": "500Mbps",
  "location": "TIVIT",
  "connectionName": "mydcinterconnect",
  "region": "sa-east-1"
}

다음 코드 예시에서는 associate-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

가상 인터페이스를 연결에 연결하려면

다음 예제에서는 지정된 가상 인터페이스를 지정된 와 연결합니다LAG. 또는 가상 인터페이스를 연결에 연결하려면 --connection-id와 같이 에 대한 AWS Direct Connect 연결의 ID를 지정합니다dxcon-ffnikghc.

명령:

aws directconnect associate-virtual-interface --connection-id dxlag-ffjhj9lx --virtual-interface-id dxvif-fgputw0j

출력:

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

다음 코드 예시에서는 confirm-connection을 사용하는 방법을 보여 줍니다.

AWS CLI

인터커넥트에서 호스팅 연결 생성을 확인하려면

다음 confirm-connection 명령은 인터커넥트에서 호스팅 연결 생성을 확인합니다.

aws directconnect confirm-connection --connection-id dxcon-fg2wi7hy

출력:

{
    "connectionState": "pending"
}

  • 자세한 API 내용은 명령 참조ConfirmConnection의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 confirm-private-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

프라이빗 가상 인터페이스의 소유권을 수락하려면

다음 confirm-private-virtual-interface 명령은 다른 고객이 생성한 프라이빗 가상 인터페이스의 소유권을 허용합니다.

aws directconnect confirm-private-virtual-interface --virtual-interface-id dxvif-fgy8orxu --virtual-gateway-id vgw-e4a47df9

출력:

{
    "virtualInterfaceState": "pending"
}

다음 코드 예시에서는 confirm-public-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

퍼블릭 가상 인터페이스의 소유권을 수락하려면

다음 confirm-public-virtual-interface 명령은 다른 고객이 생성한 퍼블릭 가상 인터페이스의 소유권을 허용합니다.

aws directconnect confirm-public-virtual-interface --virtual-interface-id dxvif-fg9xo9vp

출력:

{
    "virtualInterfaceState": "verifying"
}

다음 코드 예시에서는 confirm-transit-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

전송 가상 인터페이스의 소유권을 수락하려면

다음은 다른 고객이 생성한 전송 가상 인터페이스의 소유권을 confirm-transit-virtual-interface 허용합니다.

aws directconnect confirm-transit-virtual-interface \
    --virtual-interface-id dxvif-fEXAMPLE \
    --direct-connect-gateway-id 4112ccf9-25e9-4111-8237-b6c5dEXAMPLE

출력:

{
    "virtualInterfaceState": "pending"
}

자세한 내용은 AWS Direct Connect 사용 설명서의 호스팅 가상 인터페이스 수락을 참조하세요.

다음 코드 예시에서는 create-bgp-peer을 사용하는 방법을 보여 줍니다.

AWS CLI

IPv6 BGP 피어링 세션을 생성하려면

다음 예제에서는 프라이빗 가상 인터페이스 에서 IPv6 BGP 피어링 세션을 생성합니다dxvif-fg1vuj3d. 피어 IPv6 주소는 Amazon에서 자동으로 할당됩니다.

명령:

aws directconnect create-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --new-bgp-peer asn=64600,addressFamily=ipv6

출력:

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

  • 자세한 API 내용은 명령 참조CreateBgpPeer의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-connection을 사용하는 방법을 보여 줍니다.

AWS CLI

네트워크에서 AWS Direct Connect 위치로 연결을 생성하려면

다음 create-connection 명령은 네트워크에서 AWS Direct Connect 위치로 연결을 생성합니다.

aws directconnect create-connection --location TIVIT --bandwidth 1Gbps --connection-name "Connection to AWS"

출력:

{
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "connectionState": "requested",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

  • 자세한 API 내용은 명령 참조CreateConnection의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-direct-connect-gateway-association-proposal을 사용하는 방법을 보여 줍니다.

AWS CLI

지정된 전송 게이트웨이를 지정된 Direct Connect 게이트웨이와 연결하는 제안을 생성하려면

다음 create-direct-connect-gateway-association-proposal 예제에서는 지정된 전송 게이트웨이를 지정된 Direct Connect 게이트웨이와 연결하는 제안을 생성합니다.

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

출력:

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

자세한 내용은 AWS Direct Connect 사용 설명서의 Transit Gateway 연결 제안 생성을 참조하세요.

다음 코드 예시에서는 create-direct-connect-gateway-association을 사용하는 방법을 보여 줍니다.

AWS CLI

가상 프라이빗 게이트웨이를 Direct Connect 게이트웨이와 연결하려면

다음 예제에서는 가상 프라이빗 게이트웨이를 Direct Connect 게이트웨이 vgw-6efe725e와 연결합니다5f294f92-bafb-4011-916d-9b0bexample. 가상 프라이빗 게이트웨이가 위치한 리전에서 명령을 실행해야 합니다.

명령:

aws directconnect create-direct-connect-gateway-association --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample --virtual-gateway-id vgw-6efe725e

출력:

{
  "directConnectGatewayAssociation": {
      "associationState": "associating",
      "virtualGatewayOwnerAccount": "123456789012",
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
      "virtualGatewayId": "vgw-6efe725e",
      "virtualGatewayRegion": "us-east-2"
  }
}

다음 코드 예시에서는 create-direct-connect-gateway을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이를 생성하려면

다음 예제에서는 이름이 인 Direct Connect 게이트웨이를 생성합니다DxGateway1.

명령:

aws directconnect create-direct-connect-gateway --direct-connect-gateway-name "DxGateway1"

출력:

{
  "directConnectGateway": {
      "amazonSideAsn": 64512,
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample",
      "ownerAccount": "123456789012",
      "directConnectGatewayName": "DxGateway1",
      "directConnectGatewayState": "available"
  }
}

다음 코드 예시에서는 create-interconnect을 사용하는 방법을 보여 줍니다.

AWS CLI

파트너의 네트워크와 간의 상호 연결을 생성하려면 AWS

다음 create-interconnect 명령은 AWS Direct Connect 파트너의 네트워크와 특정 AWS Direct Connect 위치 간의 상호 연결을 생성합니다.

aws directconnect create-interconnect --interconnect-name "1G Interconnect to AWS" --bandwidth 1Gbps --location TIVIT

출력:

{
    "region": "sa-east-1",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "interconnectName": "1G Interconnect to AWS",
    "interconnectId": "dxcon-fgktov66",
    "interconnectState": "requested"
}

  • 자세한 API 내용은 명령 참조CreateInterconnect의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-lag을 사용하는 방법을 보여 줍니다.

AWS CLI

새 연결LAG로 를 생성하려면

다음 예제에서는 를 생성하고 대역폭이 1GbpsLAG인 에 대한 두 개의 새 AWS Direct Connect 연결을 LAG 요청합니다.

명령:

aws directconnect create-lag --location CSVA1 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 1GBLag

출력:

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

기존 연결을 LAG 사용하여 를 생성하려면

다음 예제에서는 계정의 기존 연결LAG에서 를 생성하고 기존 연결과 동일한 대역폭 및 위치를 LAG 가진 에 대한 두 번째 새 연결을 요청합니다.

명령:

aws directconnect create-lag --location EqDC2 --number-of-connections 2 --connections-bandwidth 1Gbps --lag-name 2ConnLAG --connection-id dxcon-fgk145dr

출력:

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

  • 자세한 API 내용은 명령 참조CreateLag의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-private-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

프라이빗 가상 인터페이스를 생성하려면

다음 create-private-virtual-interface 명령은 프라이빗 가상 인터페이스를 생성합니다.

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

출력:

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

다음 코드 예시에서는 create-public-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

퍼블릭 가상 인터페이스를 생성하려면

다음 create-public-virtual-interface 명령은 퍼블릭 가상 인터페이스를 생성합니다.

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

출력:

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

다음 코드 예시에서는 create-transit-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

전송 가상 인터페이스를 생성하려면

다음 create-transit-virtual-interface 예제에서는 지정된 연결을 위한 전송 가상 인터페이스를 생성합니다.

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

출력:

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

자세한 내용은 Direct Connect 사용 설명서의 Direct Connect Gateway에 대한 전송 가상 인터페이스 생성을 참조하세요. AWS

다음 코드 예시에서는 delete-bgp-peer을 사용하는 방법을 보여 줍니다.

AWS CLI

가상 인터페이스에서 BGP 피어를 삭제하려면

다음 예제에서는 가상 인터페이스 에서 IPv6 BGP 피어를 삭제합니다dxvif-fg1vuj3d.

명령:

aws directconnect delete-bgp-peer --virtual-interface-id dxvif-fg1vuj3d --asn 64600 --customer-address 2001:db8:1100:2f0:0:1:9cb4:4216/125

출력:

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

  • 자세한 API 내용은 명령 참조DeleteBgpPeer의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-connection을 사용하는 방법을 보여 줍니다.

AWS CLI

연결을 삭제하려면

다음 delete-connection 명령은 지정된 연결을 삭제합니다.

aws directconnect delete-connection --connection-id dxcon-fg31dyv6

출력:

{
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "connectionState": "deleted",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

  • 자세한 API 내용은 명령 참조DeleteConnection의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-direct-connect-gateway-association을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이 연결을 삭제하려면

다음 delete-direct-connect-gateway-association 예제에서는 지정된 연결 ID가 있는 전송 게이트웨이와의 Direct Connect 게이트웨이 연결을 삭제합니다.

aws directconnect delete-direct-connect-gateway-association --association-id  be85116d-46eb-4b43-a27a-da0c2ad648de

출력:

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

자세한 내용은 AWS Direct Connect 사용 설명서의 Transit Gateway 연결 및 연결 해제를 참조하세요.

다음 코드 예시에서는 delete-direct-connect-gateway을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이를 삭제하려면

다음 예제에서는 Direct Connect 게이트웨이 를 삭제합니다5f294f92-bafb-4011-916d-9b0bexample.

명령:

aws directconnect delete-direct-connect-gateway --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample

출력:

{
  "directConnectGateway": {
      "amazonSideAsn": 64512,
      "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
      "ownerAccount": "123456789012",
      "directConnectGatewayName": "DxGateway1",
      "directConnectGatewayState": "deleting"
  }
}

다음 코드 예시에서는 delete-interconnect을 사용하는 방법을 보여 줍니다.

AWS CLI

상호 연결을 삭제하려면

다음 delete-interconnect 명령은 지정된 상호 연결을 삭제합니다.

aws directconnect delete-interconnect --interconnect-id dxcon-fgktov66

출력:

{
    "interconnectState": "deleted"
}

  • 자세한 API 내용은 명령 참조DeleteInterconnect의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-lag을 사용하는 방법을 보여 줍니다.

AWS CLI

를 삭제하려면 LAG

다음 예제에서는 지정된 를 삭제합니다LAG.

명령:

aws directconnect delete-lag --lag-id dxlag-ffrhowd9

출력:

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

  • 자세한 API 내용은 명령 참조DeleteLag의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-virtual-interface을 사용하는 방법을 보여 줍니다.

AWS CLI

가상 인터페이스를 삭제하려면

다음 delete-virtual-interface 명령은 지정된 가상 인터페이스를 삭제합니다.

aws directconnect delete-virtual-interface --virtual-interface-id dxvif-ffhhk74f

출력:

{
    "virtualInterfaceState": "deleting"
}

다음 코드 예시에서는 describe-connection-loa을 사용하는 방법을 보여 줍니다.

AWS CLI

Linux 또는 Mac OS X를 사용한 연결에 대한 LOA-CFA 설명

다음 예제에서는 연결용 LOA-CFA에 대해 설명합니다dxcon-fh6ayh1d. LOA-CFA의 내용은 base64로 인코딩됩니다. 이 명령은 --output 및 --query 파라미터를 사용하여 출력을 제어하고 loaContent 구조의 내용을 추출합니다. 명령의 마지막 부분은 base64 유틸리티를 사용하여 콘텐츠를 디코딩하고 출력을 PDF 파일로 전송합니다.

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

Windows를 사용한 연결에 대한 LOA-CFA 설명

이전 예제에서는 base64 유틸리티를 사용하여 출력을 디코딩해야 합니다. Windows 컴퓨터에서certutil는 대신 를 사용할 수 있습니다. 다음 예제에서 첫 번째 명령은 LOA-CFA for connection을 설명하고 dxcon-fh6ayh1d 및 --output --query 파라미터를 사용하여 출력을 제어하고 loaContent 구조의 내용을 라는 파일에 추출합니다myLoaCfa.base64. 두 번째 명령은 certutil 유틸리티를 사용하여 파일을 디코딩하고 출력을 PDF 파일로 전송합니다.

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

출력 제어 AWS CLI에 대한 자세한 내용은 명령줄 인터페이스 사용 설명서의 AWS 명령줄 인터페이스에서 명령 출력 제어를 참조하세요. AWS

다음 코드 예시에서는 describe-connections-on-interconnect을 사용하는 방법을 보여 줍니다.

AWS CLI

상호 연결의 연결을 나열하려면

다음 describe-connections-on-interconnect 명령에는 지정된 상호 연결에서 프로비저닝된 연결이 나열됩니다.

aws directconnect describe-connections-on-interconnect --interconnect-id dxcon-fgktov66

출력:

{
    "connections": [
        {
            "partnerName": "TIVIT",
            "vlan": 101,
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffzc51m1",
            "connectionState": "ordering",
            "bandwidth": "500Mbps",
            "location": "TIVIT",
            "connectionName": "mydcinterconnect",
            "region": "sa-east-1"
        }
    ]
}

다음 코드 예시에서는 describe-connections을 사용하는 방법을 보여 줍니다.

AWS CLI

현재 리전의 모든 연결을 나열하려면

다음 describe-connections 명령은 현재 리전의 모든 연결을 나열합니다.

aws directconnect describe-connections

출력:

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

  • 자세한 API 내용은 명령 참조DescribeConnections의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-direct-connect-gateway-association-proposals을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이 연결 제안을 설명하려면

다음 describe-direct-connect-gateway-association-proposals 예제에서는 Direct Connect 게이트웨이 연결 제안에 대한 세부 정보를 보여줍니다.

aws directconnect describe-direct-connect-gateway-association-proposals

출력:

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

자세한 내용은 AWS Direct Connect 사용 설명서의 Transit Gateway 연결 및 연결 해제를 참조하세요.

다음 코드 예시에서는 describe-direct-connect-gateway-associations을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이 연결을 설명하려면

다음 예제에서는 Direct Connect 게이트웨이와의 모든 연결을 설명합니다5f294f92-bafb-4011-916d-9b0bexample.

명령:

aws directconnect describe-direct-connect-gateway-associations --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample

출력:

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

다음 코드 예시에서는 describe-direct-connect-gateway-attachments을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이 연결 설명

다음 예제에서는 Direct Connect 게이트웨이 에 연결된 가상 인터페이스를 설명합니다5f294f92-bafb-4011-916d-9b0bexample.

명령:

aws directconnect describe-direct-connect-gateway-attachments --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample

출력:

{
  "directConnectGatewayAttachments": [
      {
          "virtualInterfaceOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualInterfaceRegion": "us-east-2",
          "attachmentState": "attaching",
          "virtualInterfaceId": "dxvif-fg9zyabc"
      }
  ],
  "nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoibEhXdlNpUXF5RzhoL1JyUW52SlV2QT09IiwiYyI6Im5wQjFHQ0RyQUdRS3puNnNXcUlINCtkTTA4dTk3KzBiU0xtb05JQmlaczZ6NXRIYmk3c3VESUxFTTd6a2FzVHM0VTFwaGJkZGNxTytqWmQ3QzMzOGRQaTVrTThrOG1zelRsV3gyMWV3VTNFPSJ9"
}

다음 코드 예시에서는 describe-direct-connect-gateways을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이를 설명하려면

다음 예제에서는 모든 Direct Connect 게이트웨이를 설명합니다.

명령:

aws directconnect describe-direct-connect-gateways

출력:

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

다음 코드 예시에서는 describe-hosted-connections을 사용하는 방법을 보여 줍니다.

AWS CLI

상호 연결의 연결을 나열하려면

다음 예제에서는 지정된 인터커넥트에서 프로비저닝된 연결을 나열합니다.

명령:

aws directconnect describe-hosted-connections --connection-id dxcon-fgktov66

출력:

{
    "connections": [
        {
            "partnerName": "TIVIT",
            "vlan": 101,
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffzc51m1",
            "connectionState": "ordering",
            "bandwidth": "500Mbps",
            "location": "TIVIT",
            "connectionName": "mydcinterconnect",
            "region": "sa-east-1"
        }
    ]
}

다음 코드 예시에서는 describe-interconnect-loa을 사용하는 방법을 보여 줍니다.

AWS CLI

Linux 또는 Mac OS X를 사용한 상호 연결에 대한 LOA를CFA 설명하려면

다음 예제에서는 상호 연결용 LOA-CFA 에 대해 설명합니다dxcon-fh6ayh1d. LOA-CFA의 내용은 base64로 인코딩됩니다. 이 명령은 --output 및 --query 파라미터를 사용하여 출력을 제어하고 loaContent 구조의 내용을 추출합니다. 명령의 마지막 부분은 base64 유틸리티를 사용하여 콘텐츠를 디코딩하고 출력을 PDF 파일로 전송합니다.

aws directconnect describe-interconnect-loa --interconnect-id dxcon-fh6ayh1d --output text --query loa.loaContent|base64 --decode > myLoaCfa.pdf

Windows를 사용한 상호 연결에 대한 LOA-CFA 설명

이전 예제에서는 base64 유틸리티를 사용하여 출력을 디코딩해야 합니다. Windows 컴퓨터에서certutil는 대신 를 사용할 수 있습니다. 다음 예제에서 첫 번째 명령은 LOA-CFA for interconnect를 설명하고 dxcon-fh6ayh1d 및 --output --query 파라미터를 사용하여 출력을 제어하고 loaContent 구조의 내용을 라는 파일에 추출합니다myLoaCfa.base64. 두 번째 명령은 certutil 유틸리티를 사용하여 파일을 디코딩하고 출력을 PDF 파일로 전송합니다.

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

출력 제어 AWS CLI에 대한 자세한 내용은 명령줄 인터페이스 사용 설명서의 AWS 명령줄 인터페이스에서 명령 출력 제어를 참조하세요. AWS

다음 코드 예시에서는 describe-interconnects을 사용하는 방법을 보여 줍니다.

AWS CLI

상호 연결을 나열하려면

다음 describe-interconnects 명령은 AWS 계정에서 소유한 인터커넥트를 나열합니다.

aws directconnect describe-interconnects

출력:

{
    "interconnects": [
        {
            "region": "sa-east-1",
            "bandwidth": "1Gbps",
            "location": "TIVIT",
            "interconnectName": "1G Interconnect to AWS",
            "interconnectId": "dxcon-fgktov66",
            "interconnectState": "down"
        }
    ]
}

다음 코드 예시에서는 describe-lags을 사용하는 방법을 보여 줍니다.

AWS CLI

를 설명하려면 LAGs

다음 명령은 현재 리전의 모든 LAGs 를 설명합니다.

명령:

aws directconnect describe-lags

출력:

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

  • 자세한 API 내용은 명령 참조DescribeLags의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-loa을 사용하는 방법을 보여 줍니다.

AWS CLI

Linux 또는 Mac OS X를 사용한 연결에 대한 LOA를CFA 설명하려면

다음 예제에서는 연결용 LOA-CFA에 대해 설명합니다dxcon-fh6ayh1d. LOA-CFA의 내용은 base64로 인코딩됩니다. 이 명령은 --output 및 --query 파라미터를 사용하여 출력을 제어하고 loaContent 구조의 내용을 추출합니다. 명령의 마지막 부분은 base64 유틸리티를 사용하여 콘텐츠를 디코딩하고 출력을 PDF 파일로 전송합니다.

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

Windows를 사용한 연결에 대한 LOA-CFA 설명

이전 예제에서는 base64 유틸리티를 사용하여 출력을 디코딩해야 합니다. Windows 컴퓨터에서certutil는 대신 를 사용할 수 있습니다. 다음 예제에서 첫 번째 명령은 LOA-CFA for connection을 설명하고 dxcon-fh6ayh1d 및 --output --query 파라미터를 사용하여 출력을 제어하고 loaContent 구조의 내용을 라는 파일에 추출합니다myLoaCfa.base64. 두 번째 명령은 certutil 유틸리티를 사용하여 파일을 디코딩하고 출력을 PDF 파일로 전송합니다.

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

출력 제어 AWS CLI에 대한 자세한 내용은 명령줄 인터페이스 사용 설명서의 AWS 명령줄 인터페이스에서 명령 출력 제어를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조DescribeLoa의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-locations을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Direct Connect 파트너 및 위치를 나열하려면

다음 describe-locations 명령은 현재 리전의 AWS Direct Connect 파트너 및 위치를 나열합니다.

aws directconnect describe-locations

출력:

{
    "locations": [
        {
            "locationName": "NAP do Brasil, Barueri, Sao Paulo",
            "locationCode": "TNDB"
        },
        {
            "locationName": "Tivit - Site Transamerica (Sao Paulo)",
            "locationCode": "TIVIT"
        }
    ]
}

  • 자세한 API 내용은 명령 참조DescribeLocations의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-tags을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Direct Connect 리소스에 대한 태그를 설명하려면

다음 명령은 연결 에 대한 태그를 설명합니다dxcon-abcabc12.

명령:

aws directconnect describe-tags --resource-arns arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12

출력:

{
  "resourceTags": [
      {
          "resourceArn": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12",
          "tags": [
              {
                  "value": "VAConnection",
                  "key": "Name"
              }
          ]
      }
  ]
}

  • 자세한 API 내용은 명령 참조DescribeTags의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-virtual-gateways을 사용하는 방법을 보여 줍니다.

AWS CLI

가상 프라이빗 게이트웨이를 나열하려면

다음 describe-virtual-gateways 명령은 AWS 계정에서 소유한 가상 프라이빗 게이트웨이를 나열합니다.

aws directconnect describe-virtual-gateways

출력:

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

다음 코드 예시에서는 describe-virtual-interfaces을 사용하는 방법을 보여 줍니다.

AWS CLI

모든 가상 인터페이스를 나열하려면

다음 describe-virtual-interfaces 명령은 AWS 계정과 연결된 모든 가상 인터페이스에 대한 정보를 나열합니다.

aws directconnect describe-virtual-interfaces --connection-id dxcon-ffjrkx17

출력:

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

다음 코드 예시에서는 disassociate-connection-from-lag을 사용하는 방법을 보여 줍니다.

AWS CLI

에서 연결을 해제하려면 LAG

다음 예제에서는 지정된 연결을 지정된 에서 연결 해제합니다LAG.

명령:

aws directconnect disassociate-connection-from-lag --lag-id dxlag-fhccu14t --connection-id  dxcon-fg9607vm

출력:

{
  "ownerAccount": "123456789012",
  "connectionId": "dxcon-fg9607vm",
  "connectionState": "requested",
  "bandwidth": "1Gbps",
  "location": "EqDC2",
  "connectionName": "Con2ForLag",
  "region": "us-east-1"
}

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Direct Connect 리소스에 태그를 추가하려면

다음 명령은 키 Name 와 값이 인 태그를 연결 VAConnection에 추가합니다dxcon-abcabc12. 이 명령이 성공하면 출력이 반환되지 않습니다.

명령:

aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tags "key=Name,value=VAConnection"

  • 자세한 API 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Direct Connect 리소스에서 태그를 제거하려면

다음 명령은 연결 Name에서 키가 있는 태그를 제거합니다dxcon-abcabc12. 이 명령이 성공하면 출력이 반환되지 않습니다.

명령:

aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tag-keys Name

  • 자세한 API 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-direct-connect-gateway-association을 사용하는 방법을 보여 줍니다.

AWS CLI

Direct Connect 게이트웨이 연결의 지정된 속성을 업데이트하려면

다음 update-direct-connect-gateway-association 예제에서는 지정된 CIDR 블록을 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

출력:

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

자세한 내용은 Direct Connect 사용 설명서의 Direct Connect Gateway 작업을 참조하세요. AWS

다음 코드 예시에서는 update-lag을 사용하는 방법을 보여 줍니다.

AWS CLI

를 업데이트하려면 LAG

다음 예제에서는 지정된 의 이름을 변경합니다LAG.

명령:

aws directconnect update-lag --lag-id dxlag-ffjhj9lx --lag-name 2ConnLag

출력:

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

  • 자세한 API 내용은 명령 참조UpdateLag의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-virtual-interface-attributes을 사용하는 방법을 보여 줍니다.

AWS CLI

가상 인터페이스MTU의 를 업데이트하려면

다음 update-virtual-interface-attributes 예제에서는 지정된 가상 인터페이스MTU의 를 업데이트합니다.

aws directconnect update-virtual-interface-attributes \
    --virtual-interface-id dxvif-fEXAMPLE \
    --mtu 1500

출력:

{
    "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": []
}

자세한 내용은 AWS Direct Connect 사용 설명서의 프라이빗 가상 인터페이스MTU용 네트워크 설정 또는 가상 인터페이스 전송을 참조하세요.