AWS Direct Connect を使用した例 AWS CLI - AWS SDKコードの例
アクション

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 Association の提案の承諾または拒否」を参照してください。

次のコード例は、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"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のAllocateHostedConnection」を参照してください。

次の例は、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"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のAssociateConnectionWithLag」を参照してください。

次の例は、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"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のAssociateHostedConnection」を参照してください。

次のコード例は、associate-virtual-interface を使用する方法を示しています。

AWS CLI

仮想インターフェイスを接続に関連付けるには

次の例では、指定された仮想インターフェイスを指定された LAG に関連付けます。または、仮想インターフェイスを接続に関連付けるには、 の AWS Direct Connect 接続の ID を指定します--connection-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"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のAssociateVirtualInterface」を参照してください。

次のコード例は、confirm-connection を使用する方法を示しています。

AWS CLI

相互接続でホスト接続の作成を確認するには

次のconfirm-connectionコマンドは、相互接続でホスト接続の作成を確認します。

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

出力:

{
    "connectionState": "pending"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のConfirmConnection」を参照してください。

次のコード例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のCreateBgpPeer」を参照してください。

次の例は、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 の詳細については、 AWS CLI コマンドリファレンスの CreateConnection を参照してください。

次の例は、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 Association の提案の作成」を参照してください。

次の例は、create-direct-connect-gateway-association を使用する方法を説明しています。

AWS CLI

仮想プライベートゲートウェイを Direct Connect ゲートウェイに関連付けるには

次の例では、仮想プライベートゲートウェイvgw-6efe725eを Direct Connect ゲートウェイ に関連付けます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"
  }
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateDirectConnectGateway」を参照してください。

次の例は、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 の詳細については、 AWS CLI コマンドリファレンスの CreateInterconnect を参照してください。

次の例は、create-lag を使用する方法を説明しています。

AWS CLI

新しい接続で LAG を作成するには

次の例では、1 つの LAG を作成し、1 Gbps の帯域幅を持つ LAG の新しい AWS Direct Connect 接続を 2 つリクエストします。

コマンド:

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 の 2 番目の新しい接続をリクエストします。

コマンド:

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 の詳細については、AWS CLI 「 コマンドリファレンス」のCreateLag」を参照してください。

次の例は、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"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のCreatePublicVirtualInterface」を参照してください。

次のコード例は、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 ピアを削除するには

次の例では、仮想インターフェイス から IPv6BGP ピアを削除します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 の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteBgpPeer」を参照してください。

次の例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteConnection」を参照してください。

次の例は、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"
  }
}

  • API の詳細については、 AWS CLI コマンドリファレンスの DeleteDirectConnectGateway を参照してください。

次のコード例は、delete-interconnect を使用する方法を示しています。

AWS CLI

インターコネクトを削除するには

次のdelete-interconnectコマンドは、指定されたインターコネクトを削除します。

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

出力:

{
    "interconnectState": "deleted"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteInterconnect」を参照してください。

次の例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteLag」を参照してください。

次の例は、delete-virtual-interface を使用する方法を説明しています。

AWS CLI

仮想インターフェイスを削除するには

次のdelete-virtual-interfaceコマンドは、指定された仮想インターフェイスを削除します。

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

出力:

{
    "virtualInterfaceState": "deleting"
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteVirtualInterface」を参照してください。

次のコード例は、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 を記述dxcon-fh6ayh1dし、 --output パラメータと --queryパラメータを使用して出力を制御し、loaContent構造内容を というファイルに抽出しますmyLoaCfa.base64。2 番目のコマンドは、 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

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeConnectionLoa」を参照してください。

次の例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeConnections」を参照してください。

次の例は、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"
        }
    ]
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeHostedConnections」を参照してください。

次の例は、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 を記述dxcon-fh6ayh1dし、 --output パラメータと --queryパラメータを使用して出力を制御し、loaContent構造内容を というファイルに抽出しますmyLoaCfa.base64。2 番目のコマンドは、 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

  • API の詳細については、 AWS CLI コマンドリファレンスの DescribeInterconnectLoa を参照してください。

次のコード例は、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"
        }
    ]
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeInterconnects」を参照してください。

次のコード例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeLags」を参照してください。

次のコード例は、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 を記述dxcon-fh6ayh1dし、 --output パラメータと --queryパラメータを使用して出力を制御し、loaContent構造内容を というファイルに抽出しますmyLoaCfa.base64。2 番目のコマンドは、 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 の詳細については、 AWS CLI コマンドリファレンスの DescribeLoa を参照してください。

次のコード例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeLocations」を参照してください。

次の例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeTags」を参照してください。

次のコード例は、describe-virtual-gateways を使用する方法を示しています。

AWS CLI

仮想プライベートゲートウェイを一覧表示するには

次のdescribe-virtual-gatewaysコマンドは、 AWS アカウントが所有する仮想プライベートゲートウェイを一覧表示します。

aws directconnect describe-virtual-gateways

出力:

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

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeVirtualGateways」を参照してください。

次の例は、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"
        }
    ]
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeVirtualInterfaces」を参照してください。

次の例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のTagResource」を参照してください。

次の例は、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 の詳細については、 AWS CLI コマンドリファレンスの UntagResource を参照してください。

次のコード例は、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 の詳細については、AWS CLI 「 コマンドリファレンス」のUpdateLag」を参照してください。

次の例は、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の設定」を参照してください。