Direct Connect-Beispiele unter Verwendung von AWS CLI - AWS-SDK-Codebeispiele

Weitere AWS-SDK-Beispiele sind im GitHub-Repository Beispiele für AWS Doc SDKs verfügbar.

Direct Connect-Beispiele unter Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie AWS Command Line Interface mit Direct Connect nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Servicefunktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

Themen

Aktionen

Die folgenden Codebeispiele zeigen, wie accept-direct-connect-gateway-association-proposal verwendet wird.

AWS CLI

So akzeptieren Sie einen Gateway-Zuordnungsvorschlag

Im folgenden Beispiel für accept-direct-connect-gateway-association-proposal wird der angegebene Vorschlag akzeptiert.

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

Weitere Informationen finden Sie unter Akzeptieren oder Ablehnen eines Transit-Gateway-Zuordnungsvorschlags im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie allocate-connection-on-interconnect verwendet wird.

AWS CLI

So erstellen Sie eine gehostete Verbindung über eine Interconnect-Verbindung

Der folgende allocate-connection-on-interconnect-Befehl erstellt eine gehostete Verbindung über eine Interconnect-Verbindung:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie allocate-hosted-connection verwendet wird.

AWS CLI

So erstellen Sie eine gehostete Verbindung über eine Interconnect-Verbindung

Im folgenden Beispiel für allocate-hosted-connection wird eine gehostete Verbindung über die angegebene Interconnect-Verbindung erstellt.

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie allocate-private-virtual-interface verwendet wird.

AWS CLI

So stellen Sie eine private virtuelle Schnittstelle bereit

Der folgende allocate-private-virtual-interface-Befehl stellt eine private virtuelle Schnittstelle bereit, deren Eigentümer ein anderer Kunde sein soll:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie allocate-public-virtual-interface verwendet wird.

AWS CLI

So stellen Sie eine öffentliche virtuelle Schnittstelle bereit

Der folgende allocate-public-virtual-interface-Befehl stellt eine öffentliche virtuelle Schnittstelle bereit, deren Eigentümer ein anderer Kunde sein soll:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie allocate-transit-virtual-interface verwendet wird.

AWS CLI

So stellen Sie eine virtuelle Transit-Schnittstelle bereit, deren Eigentümer das angegebene AWS-Konto sein soll

Im folgenden Beispiel für allocate-transit-virtual-interface wird eine virtuelle Transit-Schnittstelle für das angegebene Konto bereitgestellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen einer gehosteten virtuellen Transit-Schnittstelle im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie associate-connection-with-lag verwendet wird.

AWS CLI

So verknüpfen Sie eine Verbindung mit einer LAG

Im folgenden Beispiel wird die angegebene Verbindung der spezifizierten LAG zugeordnet.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie associate-hosted-connection verwendet wird.

AWS CLI

So verknüpfen Sie eine gehostete Verbindung mit einer LAG

Im folgenden Beispiel wird die angegebene gehostete Verbindung der spezifizierten LAG zugeordnet.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie associate-virtual-interface verwendet wird.

AWS CLI

So verknüpfen Sie eine virtuelle Schnittstelle mit einer Verbindung

Im folgenden Beispiel wird die angegebene virtuelle Schnittstelle der spezifizierten LAG zugeordnet. Wenn Sie die virtuelle Schnittstelle einer Verbindung zuordnen möchten, geben Sie alternativ die ID einer Verbindung von AWS Direct Connect für --connection-id an, zum Beispiel dxcon-ffnikghc.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie confirm-connection verwendet wird.

AWS CLI

So bestätigen Sie die Erstellung einer gehosteten Verbindung über eine Interconnect-Verbindung

Der folgende confirm-connection-Befehl bestätigt die Erstellung einer gehosteten Verbindung über eine Interconnect-Verbindung:

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

Ausgabe:

{ "connectionState": "pending" }
  • Weitere API-Informationen finden Sie unter ConfirmConnection in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie confirm-private-virtual-interface verwendet wird.

AWS CLI

So übernehmen Sie das Eigentum an einer privaten virtuellen Schnittstelle

Mit dem folgenden confirm-private-virtual-interface-Befehl wird das Eigentum an einer von einem anderen Kunden erstellten privaten virtuellen Schnittstelle übernommen:

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

Ausgabe:

{ "virtualInterfaceState": "pending" }

Die folgenden Codebeispiele zeigen, wie confirm-public-virtual-interface verwendet wird.

AWS CLI

So übernehmen Sie das Eigentum an einer öffentlichen virtuellen Schnittstelle

Mit dem folgenden confirm-public-virtual-interface-Befehl wird das Eigentum an einer von einem anderen Kunden erstellten öffentlichen virtuellen Schnittstelle übernommen:

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

Ausgabe:

{ "virtualInterfaceState": "verifying" }

Die folgenden Codebeispiele zeigen, wie confirm-transit-virtual-interface verwendet wird.

AWS CLI

So übernehmen Sie das Eigentum an einer virtuellen Transit-Schnittstelle

Im folgenden Beispiel für confirm-transit-virtual-interface wird das Eigentum an einer von einem anderen Kunden erstellten virtuellen Transit-Schnittstelle übernommen.

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

Ausgabe:

{ "virtualInterfaceState": "pending" }

Weitere Informationen finden Sie unter Akzeptieren einer gehosteten virtuellen Schnittstelle im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie create-bgp-peer verwendet wird.

AWS CLI

So erstellen Sie eine IPv6-BGP-Peering-Sitzung

Im folgenden Beispiel wird eine IPv6-BGP-Peering-Sitzung auf einer privaten virtuellen Schnittstelle dxvif-fg1vuj3d erstellt. Die Peer-IPv6-Adressen werden von Amazon automatisch zugewiesen.

Befehl:

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

Ausgabe:

{ "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" } }
  • Weitere API-Informationen finden Sie unter CreateBgpPeer in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-connection verwendet wird.

AWS CLI

So stellen Sie eine Verbindung von Ihrem Netzwerk zu einem Standort von AWS Direct Connect her

Mit dem folgenden create-connection-Befehl wird eine Verbindung von Ihrem Netzwerk zu einem Standort von AWS Direct Connect hergestellt:

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

Ausgabe:

{ "ownerAccount": "123456789012", "connectionId": "dxcon-fg31dyv6", "connectionState": "requested", "bandwidth": "1Gbps", "location": "TIVIT", "connectionName": "Connection to AWS", "region": "sa-east-1" }
  • Weitere API-Informationen finden Sie unter CreateConnection in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-direct-connect-gateway-association-proposal verwendet wird.

AWS CLI

So erstellen Sie einen Vorschlag zum Verknüpfen des angegebenen Transit-Gateways mit dem genannten Direct Connect Gateway

Im folgenden Beispiel für create-direct-connect-gateway-association-proposal wird ein Vorschlag zum Verknüpfen des angegebenen Transit-Gateways mit dem genannten Direct Connect Gateway erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Transit-Gateway-Zuordnungsvorschlags im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie create-direct-connect-gateway-association verwendet wird.

AWS CLI

So verknüpfen Sie ein Virtual Private Gateway mit einem Direct Connect Gateway

Im folgenden Beispiel wird das Virtual Private Gateway vgw-6efe725e mit dem Direct Connect Gateway 5f294f92-bafb-4011-916d-9b0bexample verknüpft. Sie müssen den Befehl in der Region ausführen, in der sich das Virtual Private Gateway befindet.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie create-direct-connect-gateway verwendet wird.

AWS CLI

So erstellen Sie ein Direct-Connect-Gateway

Im folgenden Beispiel wird ein Direct-Connect-Gateway mit dem Namen DxGateway1 erstellt.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie create-interconnect verwendet wird.

AWS CLI

So stellen Sie eine Interconnect-Verbindung zwischen dem Netzwerk eines Partners und AWS her

Der folgende create-interconnect-Befehl stellt eine Interconnect-Verbindung zwischen dem Netzwerk eines Partners von AWS Direct Connect und einem bestimmten Standort von AWS Direct Connect her:

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

Ausgabe:

{ "region": "sa-east-1", "bandwidth": "1Gbps", "location": "TIVIT", "interconnectName": "1G Interconnect to AWS", "interconnectId": "dxcon-fgktov66", "interconnectState": "requested" }
  • Weitere API-Informationen finden Sie unter CreateInterconnect in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-lag verwendet wird.

AWS CLI

So erstellen Sie eine LAG mit neuen Verbindungen

Im folgenden Beispiel wird eine LAG erstellt und zwei neue Verbindungen von AWS Direct Connect für die LAG mit einer Bandbreite von 1 Gbit/s werden angefordert.

Befehl:

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

Ausgabe:

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

So erstellen Sie eine LAG anhand einer vorhandenen Verbindung

Im folgenden Beispiel werden eine LAG aus einer bestehenden Verbindung in Ihrem Konto erstellt und eine zweite neue Verbindung für die LAG mit derselben Bandbreite und demselben Standort wie die bestehende Verbindung angefordert.

Befehl:

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

Ausgabe:

{ "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" }
  • Weitere API-Informationen finden Sie unter CreateLag in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-private-virtual-interface verwendet wird.

AWS CLI

So erstellen Sie eine private, virtuelle Schnittstelle

Der folgende create-private-virtual-interface-Befehl erstellt eine private virtuelle Schnittstelle:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie create-public-virtual-interface verwendet wird.

AWS CLI

So erstellen Sie eine öffentliche virtuelle Schnittstelle

Der folgende create-public-virtual-interface-Befehl erstellt eine öffentliche virtuelle Schnittstelle:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie create-transit-virtual-interface verwendet wird.

AWS CLI

So erstellen Sie eine virtuelle Transit-Schnittstelle

Im folgenden Beispiel für create-transit-virtual-interface wird eine virtuelle Transit-Schnittstelle für die angegebene Verbindung erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen einer virtuellen Transit-Schnittstelle für das Direct-Connect-Gateway im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie delete-bgp-peer verwendet wird.

AWS CLI

So löschen Sie einen BGP-Peer von einer virtuellen Schnittstelle

Im folgenden Beispiel wird der IPv6-BGP-Peer von der virtuellen Schnittstelle dxvif-fg1vuj3d gelöscht.

Befehl:

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

Ausgabe:

{ "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" } }
  • Weitere API-Informationen finden Sie unter DeleteBgpPeer in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-connection verwendet wird.

AWS CLI

So löschen Sie eine Verbindung

Der folgende delete-connection-Befehl löscht die angegebene Verbindung.

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

Ausgabe:

{ "ownerAccount": "123456789012", "connectionId": "dxcon-fg31dyv6", "connectionState": "deleted", "bandwidth": "1Gbps", "location": "TIVIT", "connectionName": "Connection to AWS", "region": "sa-east-1" }
  • Weitere API-Informationen finden Sie unter DeleteConnection in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-direct-connect-gateway-association verwendet wird.

AWS CLI

So löschen Sie eine Zuordnung des Direct-Connect-Gateways

Im folgenden Beispiel für delete-direct-connect-gateway-association wird die Zuordnung des Direct-Connect-Gateways zu einem Transit-Gateway gelöscht, das die angegebene Zuordnungs-ID hat.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Zuordnen und Aufheben der Zuordnung von Transit-Gateways im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie delete-direct-connect-gateway verwendet wird.

AWS CLI

So löschen Sie ein Direct-Connect-Gateway

Im folgenden Beispiel wird das Direct-Connect-Gateway 5f294f92-bafb-4011-916d-9b0bexample gelöscht.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie delete-interconnect verwendet wird.

AWS CLI

So löschen Sie eine Interconnect-Verbindung

Der folgende delete-interconnect-Befehl löscht die angegebene Interconnect-Verbindung:

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

Ausgabe:

{ "interconnectState": "deleted" }
  • Weitere API-Informationen finden Sie unter DeleteInterconnect in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-lag verwendet wird.

AWS CLI

So löschen Sie eine LAG

Im folgenden Beispiel wird die angegebene LAG gelöscht.

Befehl:

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

Ausgabe:

{ "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" }
  • Weitere API-Informationen finden Sie unter DeleteLag in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-virtual-interface verwendet wird.

AWS CLI

So löschen Sie eine virtuelle Schnittstelle

Der folgende delete-virtual-interface-Befehl löscht die angegebene virtuelle Schnittstelle:

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

Ausgabe:

{ "virtualInterfaceState": "deleting" }

Die folgenden Codebeispiele zeigen, wie describe-connection-loa verwendet wird.

AWS CLI

So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Linux oder Mac OS X

Das folgende Beispiel beschreibt Ihre LOA-CFA für die Verbindung dxcon-fh6ayh1d. Der Inhalt der LOA-CFA ist base64-kodiert. Dieser Befehl verwendet die Parameter --output und --query, um die Ausgabe zu steuern und den Inhalt der Struktur loaContent zu extrahieren. Der letzte Teil des Befehls decodiert den Inhalt mit dem base64-Dienstprogramm und sendet die Ausgabe an eine PDF-Datei.

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

So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Windows

Das vorherige Beispiel erfordert die Verwendung des base64-Dienstprogramms, um die Ausgabe zu decodieren. Auf einem Windows-Computer können Sie stattdessen certutil verwenden. Im folgenden Beispiel beschreibt der erste Befehl Ihre LOA-CFA für die Verbindung dxcon-fh6ayh1d und verwendet die Parameter --output und --query, um die Ausgabe zu steuern sowie den Inhalt der Struktur loaContent in eine Datei mit dem Namen myLoaCfa.base64 zu extrahieren. Der zweite Befehl verwendet das certutil-Dienstprogramm um die Datei zu dekodieren und die Ausgabe an eine PDF-Datei zu senden.

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

Weitere Informationen zum Steuern der AWS-CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe aus der AWS-Befehlszeilenschnittstelle im Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle.

Die folgenden Codebeispiele zeigen, wie describe-connections-on-interconnect verwendet wird.

AWS CLI

So listen Sie Verbindungen über eine Interconnect-Verbindung auf

Der folgende describe-connections-on-interconnect-Befehl listet die Verbindungen auf, die über die angegebene Interconnect-Verbindung bereitgestellt wurden:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie describe-connections verwendet wird.

AWS CLI

So listen Sie alle Verbindungen in der aktuellen Region auf

Der folgende describe-connections-Befehl listet alle Verbindungen in der aktuellen Region auf:

aws directconnect describe-connections

Ausgabe:

{ "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" } ] }
  • Weitere API-Informationen finden Sie unter DescribeConnections in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-direct-connect-gateway-association-proposals verwendet wird.

AWS CLI

So beschreiben Sie die Zuordnungsvorschläge für Ihr Direct-Connect-Gateway

Im folgenden Beispiel für describe-direct-connect-gateway-association-proposals werden Details zu den Zuordnungsvorschlägen für Ihr Direct-Connect-Gateway angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Zuordnen und Aufheben der Zuordnung von Transit-Gateways im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie describe-direct-connect-gateway-associations verwendet wird.

AWS CLI

So beschreiben Sie Zuordnungen des Direct-Connect-Gateways

Das folgende Beispiel beschreibt alle Zuordnungen zum Direct-Connect-Gateway 5f294f92-bafb-4011-916d-9b0bexample.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie describe-direct-connect-gateway-attachments verwendet wird.

AWS CLI

So beschreiben Sie Anhänge des Direct-Connect-Gateways

Das folgende Beispiel beschreibt die virtuellen Schnittstellen, die an das Direct-Connect-Gateway 5f294f92-bafb-4011-916d-9b0bexample angehängt sind.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie describe-direct-connect-gateways verwendet wird.

AWS CLI

So beschreiben Sie Ihre Direct-Connect-Gateways

Das folgende Beispiel beschreibt alle Ihre Direct-Connect-Gateways.

Befehl:

aws directconnect describe-direct-connect-gateways

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie describe-hosted-connections verwendet wird.

AWS CLI

So listen Sie Verbindungen über eine Interconnect-Verbindung auf

Im folgenden Beispiel wird die Verbindungen aufgelistet, die über die angegebene Interconnect-Verbindung bereitgestellt wurden.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie describe-interconnect-loa verwendet wird.

AWS CLI

So beschreiben Sie Ihre LOA-CFA für eine Interconnect-Verbindung unter Linux oder Mac OS X

Das folgende Beispiel beschreibt Ihre LOA-CFA für die Interconnect-Verbindung dxcon-fh6ayh1d. Der Inhalt der LOA-CFA ist base64-kodiert. Dieser Befehl verwendet die Parameter --output und --query, um die Ausgabe zu steuern und den Inhalt der Struktur loaContent zu extrahieren. Der letzte Teil des Befehls decodiert den Inhalt mit dem base64-Dienstprogramm und sendet die Ausgabe an eine PDF-Datei.

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

So beschreiben Sie Ihre LOA-CFA für eine Interconnect-Verbindung unter Windows

Das vorherige Beispiel erfordert die Verwendung des base64-Dienstprogramms, um die Ausgabe zu decodieren. Auf einem Windows-Computer können Sie stattdessen certutil verwenden. Im folgenden Beispiel beschreibt der erste Befehl Ihre LOA-CFA für die Interconnect-Verbindung dxcon-fh6ayh1d und verwendet die Parameter --output und --query, um die Ausgabe zu steuern sowie den Inhalt der Struktur loaContent in eine Datei mit dem Namen myLoaCfa.base64 zu extrahieren. Der zweite Befehl verwendet das certutil-Dienstprogramm um die Datei zu dekodieren und die Ausgabe an eine PDF-Datei zu senden.

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

Weitere Informationen zum Steuern der AWS-CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe aus der AWS-Befehlszeilenschnittstelle im Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle.

Die folgenden Codebeispiele zeigen, wie describe-interconnects verwendet wird.

AWS CLI

So listen Sie Interconnect-Verbindungen auf

Der folgende describe-interconnects-Befehl listet die Interconnect-Verbindungen auf, die Ihrem AWS-Konto gehören:

aws directconnect describe-interconnects

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie describe-lags verwendet wird.

AWS CLI

So beschreiben Sie Ihre LAGs

Der folgende Befehl beschreibt alle Ihre LAGs für die aktuelle Region.

Befehl:

aws directconnect describe-lags

Ausgabe:

{ "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" } ] }
  • Weitere API-Informationen finden Sie unter DescribeLags in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-loa verwendet wird.

AWS CLI

So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Linux oder Mac OS X

Das folgende Beispiel beschreibt Ihre LOA-CFA für die Verbindung dxcon-fh6ayh1d. Der Inhalt der LOA-CFA ist base64-kodiert. Dieser Befehl verwendet die Parameter --output und --query, um die Ausgabe zu steuern und den Inhalt der Struktur loaContent zu extrahieren. Der letzte Teil des Befehls decodiert den Inhalt mit dem base64-Dienstprogramm und sendet die Ausgabe an eine PDF-Datei.

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

So beschreiben Sie Ihre LOA-CFA für eine Verbindung unter Windows

Das vorherige Beispiel erfordert die Verwendung des base64-Dienstprogramms, um die Ausgabe zu decodieren. Auf einem Windows-Computer können Sie stattdessen certutil verwenden. Im folgenden Beispiel beschreibt der erste Befehl Ihre LOA-CFA für die Verbindung dxcon-fh6ayh1d und verwendet die Parameter --output und --query, um die Ausgabe zu steuern sowie den Inhalt der Struktur loaContent in eine Datei mit dem Namen myLoaCfa.base64 zu extrahieren. Der zweite Befehl verwendet das certutil-Dienstprogramm um die Datei zu dekodieren und die Ausgabe an eine PDF-Datei zu senden.

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

Weitere Informationen zum Steuern der AWS-CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe aus der AWS-Befehlszeilenschnittstelle im Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle.

  • Weitere API-Informationen finden Sie unter DescribeLoa in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-locations verwendet wird.

AWS CLI

So listen Sie Partner und Standorte von AWS Direct Connect auf

Der folgende describe-locations-Befehl listet Partner und Standorte von AWS Direct Connect in der aktuellen Region auf:

aws directconnect describe-locations

Ausgabe:

{ "locations": [ { "locationName": "NAP do Brasil, Barueri, Sao Paulo", "locationCode": "TNDB" }, { "locationName": "Tivit - Site Transamerica (Sao Paulo)", "locationCode": "TIVIT" } ] }
  • Weitere API-Informationen finden Sie unter DescribeLocations in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-tags verwendet wird.

AWS CLI

So beschreiben Sie Tags für Ihre Ressourcen von AWS Direct Connect

Der folgende Befehl beschreibt die Tags für die Verbindung dxcon-abcabc12.

Befehl:

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

Ausgabe:

{ "resourceTags": [ { "resourceArn": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12", "tags": [ { "value": "VAConnection", "key": "Name" } ] } ] }
  • Weitere API-Informationen finden Sie unter DescribeTags in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-virtual-gateways verwendet wird.

AWS CLI

So listen Sie Virtual Private Gateways auf

Der folgende describe-virtual-gateways-Befehl listet Virtual Private Gateways auf, die Ihrem AWS-Konto gehören:

aws directconnect describe-virtual-gateways

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie describe-virtual-interfaces verwendet wird.

AWS CLI

So listen Sie alle virtuellen Schnittstellen auf

Der folgende describe-virtual-interfaces-Befehl listet die Informationen zu allen virtuellen Schnittstellen auf, die Ihrem AWS-Konto zugeordnet sind:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie disassociate-connection-from-lag verwendet wird.

AWS CLI

So heben Sie die Verknüpfung einer Verbindung mit einer LAG auf

Im folgenden Beispiel wird die Zuordnung der angegebene Verbindung zu der spezifizierten LAG aufgehoben.

Befehl:

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

Ausgabe:

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

Die folgenden Codebeispiele zeigen, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie einer Ressource von AWS Direct Connect ein Tag hinzu

Der folgende Befehl fügt der Verbindung dxcon-abcabc12 ein Tag mit dem Schlüssel Name und dem Wert VAConnection hinzu. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben.

Befehl:

aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tags "key=Name,value=VAConnection"
  • Weitere API-Informationen finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie ein Tag aus einer Ressource von AWS Direct Connect

Mit dem folgenden Befehl wird das Tag mit dem Schlüssel Name aus der Verbindung dxcon-abcabc12 entfernt. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben.

Befehl:

aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tag-keys Name
  • Weitere API-Informationen finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie update-direct-connect-gateway-association verwendet wird.

AWS CLI

So aktualisieren Sie die angegebenen Attribute der Zuordnung des Direct-Connect-Gateways

Im folgenden Beispiel für update-direct-connect-gateway-association wird der angegebene CIDR-Block einer Zuordnung des Direct-Connect-Gateways hinzugefügt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Arbeiten mit Direct-Connect-Gateways im Benutzerhandbuch für AWS Direct Connect.

Die folgenden Codebeispiele zeigen, wie update-lag verwendet wird.

AWS CLI

So aktualisieren Sie eine LAG

Im folgenden Beispiel wird der Name der angegebenen LAG geändert.

Befehl:

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

Ausgabe:

{ "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" }
  • Weitere API-Informationen finden Sie unter UpdateLag in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie update-virtual-interface-attributes verwendet wird.

AWS CLI

So aktualisieren Sie die MTU für eine virtuelle Schnittstelle

Im folgenden Beispiel für update-virtual-interface-attributes wird die MTU der angegebenen virtuellen Schnittstelle aktualisiert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Festlegen des Netzwerk-MTU für private virtuelle Schnittstellen oder virtuelle Transit-Schnittstellen im Benutzerhandbuch für AWS Direct Connect.