文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 AWS SDK 範例
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS Direct Connect 使用 的範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 來執行動作和實作常見案例 AWS Direct Connect。
Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境中查看內容中的動作。
每個範例都包含完整原始程式碼的連結,您可以在其中找到如何在內容中設定和執行程式碼的指示。
主題
動作
下列程式碼範例示範如何使用 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-idcb7f41cb-8128-43a5-93b1-dcaedEXAMPLE
\ --associated-gateway-owner-account111122223333
{
"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 使用者指南中的接受或拒絕傳輸閘道關聯提案。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 AcceptDirectConnectGatewayAssociationProposal
。
-
下列程式碼範例示範如何使用 allocate-connection-on-interconnect
。
- AWS CLI
-
在互連上建立託管連線
下列
allocate-connection-on-interconnect
命令會在互連上建立託管連線:aws directconnect allocate-connection-on-interconnect --bandwidth
500Mbps
--connection-namemydcinterconnect
--owner-account123456789012
--interconnect-iddxcon-fgktov66
--vlan101
輸出:
{ "partnerName": "TIVIT", "vlan": 101, "ownerAccount": "123456789012", "connectionId": "dxcon-ffzc51m1", "connectionState": "ordering", "bandwidth": "500Mbps", "location": "TIVIT", "connectionName": "mydcinterconnect", "region": "sa-east-1" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 AllocateConnectionOnInterconnect
。
-
下列程式碼範例示範如何使用 allocate-hosted-connection
。
- AWS CLI
-
在互連上建立託管連線
下列
allocate-hosted-connection
範例會在指定的互連上建立託管連線。aws directconnect allocate-hosted-connection \ --bandwidth
500Mbps
\ --connection-namemydcinterconnect
\ --owner-account123456789012
-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-account123456789012
--new-private-virtual-interface-allocationvirtualInterfaceName=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" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 AllocatePrivateVirtualInterface
。
-
下列程式碼範例示範如何使用 allocate-public-virtual-interface
。
- AWS CLI
-
佈建公有虛擬介面
下列
allocate-public-virtual-interface
命令會佈建由不同客戶擁有的公有虛擬介面:aws directconnect allocate-public-virtual-interface --connection-id
dxcon-ffjrkx17
--owner-account123456789012
--new-public-virtual-interface-allocationvirtualInterfaceName=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" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 AllocatePublicVirtualInterface
。
-
下列程式碼範例示範如何使用 allocate-transit-virtual-interface
。
- AWS CLI
-
佈建要由指定 AWS 帳戶擁有的傳輸虛擬介面
下列
allocate-transit-virtual-interface
範例為指定的帳戶佈建傳輸虛擬介面。aws directconnect allocate-transit-virtual-interface \ --connection-id
dxlag-fEXAMPLE
\ --owner-account123456789012
\ --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 使用者指南中的建立託管傳輸虛擬介面。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 AllocateTransitVirtualInterface
。
-
下列程式碼範例示範如何使用 associate-connection-with-lag
。
- AWS CLI
-
將連線與 LAG 建立關聯
下列範例會將指定的連線與指定的 LAG 建立關聯。
命令:
aws directconnect associate-connection-with-lag --lag-id
dxlag-fhccu14t
--connection-iddxcon-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-iddxcon-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-iddxvif-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-idvgw-e4a47df9
輸出:
{ "virtualInterfaceState": "pending" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 ConfirmPrivateVirtualInterface
。
-
下列程式碼範例示範如何使用 confirm-public-virtual-interface
。
- AWS CLI
-
接受公有虛擬介面的擁有權
下列
confirm-public-virtual-interface
命令接受另一個客戶建立的公有虛擬介面的擁有權:aws directconnect confirm-public-virtual-interface --virtual-interface-id
dxvif-fg9xo9vp
輸出:
{ "virtualInterfaceState": "verifying" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 ConfirmPublicVirtualInterface
。
-
下列程式碼範例示範如何使用 confirm-transit-virtual-interface
。
- AWS CLI
-
接受傳輸虛擬介面的所有權
以下
confirm-transit-virtual-interface
接受由其他客戶建立的傳輸虛擬介面的所有權。aws directconnect confirm-transit-virtual-interface \ --virtual-interface-id
dxvif-fEXAMPLE
\ --direct-connect-gateway-id4112ccf9-25e9-4111-8237-b6c5dEXAMPLE
輸出:
{ "virtualInterfaceState": "pending" }
如需詳細資訊,請參閱 AWS Direct Connect 使用者指南中的接受託管虛擬介面。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 ConfirmTransitVirtualInterface
。
-
下列程式碼範例示範如何使用 create-bgp-peer
。
- AWS CLI
-
建立 IPv6 BGP 對等互連工作階段
下列範例會在私有虛擬介面 上建立 IPv6 BGP 對等工作階段
dxvif-fg1vuj3d
。Amazon 會自動配置對等 IPv6 地址。命令:
aws directconnect create-bgp-peer --virtual-interface-id
dxvif-fg1vuj3d
--new-bgp-peerasn=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
--bandwidth1Gbps
--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-account111122223333
\ --gateway-idtgw-02f776b1a7EXAMPLE
\ --add-allowed-prefixes-to-direct-connect-gatewaycidr=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 使用者指南中的建立傳輸閘道關聯提案。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 CreateDirectConnectGatewayAssociationProposal
。
-
下列程式碼範例示範如何使用 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-idvgw-6efe725e
輸出:
{ "directConnectGatewayAssociation": { "associationState": "associating", "virtualGatewayOwnerAccount": "123456789012", "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample", "virtualGatewayId": "vgw-6efe725e", "virtualGatewayRegion": "us-east-2" } }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 CreateDirectConnectGatewayAssociation
。
-
下列程式碼範例示範如何使用 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"
--bandwidth1Gbps
--locationTIVIT
輸出:
{ "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
下列範例會建立 LAG,並請求兩個頻寬為 1 Gbps 的 LAG 新 AWS Direct Connect 連線。
命令:
aws directconnect create-lag --location
CSVA1
--number-of-connections2
--connections-bandwidth1Gbps
--lag-name1GBLag
輸出:
{ "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,並請求具有與現有連線相同頻寬和位置的第二個新連線。
命令:
aws directconnect create-lag --location
EqDC2
--number-of-connections2
--connections-bandwidth1Gbps
--lag-name2ConnLAG
--connection-iddxcon-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-interfacevirtualInterfaceName=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" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 CreatePrivateVirtualInterface
。
-
下列程式碼範例示範如何使用 create-public-virtual-interface
。
- AWS CLI
-
建立公有虛擬介面
下列
create-public-virtual-interface
命令會建立公有虛擬介面:aws directconnect create-public-virtual-interface --connection-id
dxcon-ffjrkx17
--new-public-virtual-interfacevirtualInterfaceName=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
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 CreateTransitVirtualInterface
。
-
下列程式碼範例示範如何使用 delete-bgp-peer
。
- AWS CLI
-
從虛擬介面刪除 BGP 對等
下列範例會從虛擬介面 刪除 IPv6 BGP 對等
dxvif-fg1vuj3d
。命令:
aws directconnect delete-bgp-peer --virtual-interface-id
dxvif-fg1vuj3d
--asn64600
--customer-address2001: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
範例會刪除 Direct Connect 閘道與具有指定關聯 ID 之傳輸閘道的關聯。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 使用者指南中的關聯和取消關聯傳輸閘道。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DeleteDirectConnectGatewayAssociation
。
-
下列程式碼範例示範如何使用 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
--outputtext
--queryloa.loaContent|base64
--decode>
myLoaCfa.pdf
使用 Windows 描述連線的 LOA-CFA
先前的範例需要使用
base64
公用程式來解碼輸出。在 Windows 電腦上,您可以certutil
改為使用 。在下列範例中,第一個命令描述您的 LOA-CFA 進行連線,dxcon-fh6ayh1d
並使用--output
和--query
參數來控制輸出,並將loaContent
結構的內容擷取至名為 的檔案myLoaCfa.base64
。第二個命令使用certutil
公用程式將該檔案解碼並傳送輸出至 PDF 檔案。aws directconnect describe-connection-loa --connection-id
dxcon-fh6ayh1d
--outputtext
--queryloa.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" } ] }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DescribeConnectionsOnInterconnect
。
-
下列程式碼範例示範如何使用 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 使用者指南中的關聯和取消關聯傳輸閘道。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DescribeDirectConnectGatewayAssociationProposals
。
-
下列程式碼範例示範如何使用 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" } ] }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DescribeDirectConnectGatewayAssociations
。
-
下列程式碼範例示範如何使用 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" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DescribeDirectConnectGatewayAttachments
。
-
下列程式碼範例示範如何使用 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" } ] }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DescribeDirectConnectGateways
。
-
下列程式碼範例示範如何使用 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
--outputtext
--queryloa.loaContent|base64
--decode>
myLoaCfa.pdf
使用 Windows 描述互連的 LOA-CFA
先前的範例需要使用
base64
公用程式來解碼輸出。在 Windows 電腦上,您可以certutil
改為使用 。在下列範例中,第一個命令描述您的 LOA-CFA 進行互連,dxcon-fh6ayh1d
並使用--output
和--query
參數來控制輸出,並將loaContent
結構的內容擷取至名為 的檔案myLoaCfa.base64
。第二個命令使用certutil
公用程式將該檔案解碼並傳送輸出至 PDF 檔案。aws directconnect describe-interconnect-loa --interconnect-id
dxcon-fh6ayh1d
--outputtext
--queryloa.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
--outputtext
--queryloa.loaContent|base64
--decode>
myLoaCfa.pdf
使用 Windows 描述連線的 LOA-CFA
先前的範例需要使用
base64
公用程式來解碼輸出。在 Windows 電腦上,您可以certutil
改為使用 。在下列範例中,第一個命令描述您的 LOA-CFA 進行連線,dxcon-fh6ayh1d
並使用--output
和--query
參數來控制輸出,並將loaContent
結構的內容擷取至名為 的檔案myLoaCfa.base64
。第二個命令使用certutil
公用程式將該檔案解碼並傳送輸出至 PDF 檔案。aws directconnect describe-loa --connection-id
dxcon-fh6ayh1d
--outputtext
--queryloa.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-iddxcon-fg9607vm
輸出:
{ "ownerAccount": "123456789012", "connectionId": "dxcon-fg9607vm", "connectionState": "requested", "bandwidth": "1Gbps", "location": "EqDC2", "connectionName": "Con2ForLag", "region": "us-east-1" }
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DisassociateConnectionFromLag
。
-
下列程式碼範例示範如何使用 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-keysName
-
如需 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-gatewaycidr=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 Gateways。 AWS
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 UpdateDirectConnectGatewayAssociation
。
-
下列程式碼範例示範如何使用 update-lag
。
- AWS CLI
-
更新 LAG
下列範例會變更指定 LAG 的名稱。
命令:
aws directconnect update-lag --lag-id
dxlag-ffjhj9lx
--lag-name2ConnLag
輸出:
{ "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
\ --mtu1500
輸出:
{ "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。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 UpdateVirtualInterfaceAttributes
。
-