View a markdown version of this page

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

Weitere AWS SDK-Beispiele sind im AWS Doc SDK Examples GitHub Repo verfügbar.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Direct Connect Beispiele unter Verwendung AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und gängige Szenarien implementieren Direct Connect.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen 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

Das folgende Codebeispiel zeigt die Verwendung. accept-direct-connect-gateway-association-proposal

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.

Das folgende Codebeispiel zeigt die Verwendung. allocate-connection-on-interconnect

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

Das folgende Codebeispiel zeigt die Verwendung. allocate-hosted-connection

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

Das folgende Codebeispiel zeigt die Verwendung. allocate-private-virtual-interface

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

Das folgende Codebeispiel zeigt die Verwendung. allocate-public-virtual-interface

AWS CLI

Um eine öffentliche virtuelle Schnittstelle bereitzustellen

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

Das folgende Codebeispiel zeigt die Verwendungallocate-transit-virtual-interface.

AWS CLI

Um eine virtuelle Transitschnittstelle bereitzustellen, die dem angegebenen AWS Konto gehört

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.

Das folgende Codebeispiel zeigt die Verwendung. associate-connection-with-lag

AWS CLI

Um eine Verbindung einer LAG zuzuordnen

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

Das folgende Codebeispiel zeigt die Verwendung. associate-hosted-connection

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

Das folgende Codebeispiel zeigt die Verwendung. associate-virtual-interface

AWS CLI

Um eine virtuelle Schnittstelle einer Verbindung zuzuordnen

Im folgenden Beispiel wird die angegebene virtuelle Schnittstelle der spezifizierten LAG zugeordnet. Um die virtuelle Schnittstelle einer Verbindung zuzuordnen, geben Sie alternativ die ID einer AWS Direct Connect-Verbindung für --connection-id an, zum Beispieldxcon-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"
}

Das folgende Codebeispiel zeigt die Verwendung. confirm-connection

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

Das folgende Codebeispiel zeigt die Verwendung. confirm-private-virtual-interface

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

Das folgende Codebeispiel zeigt die Verwendung. confirm-public-virtual-interface

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

Das folgende Codebeispiel zeigt die Verwendung. confirm-transit-virtual-interface

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.

Das folgende Codebeispiel zeigt die Verwendung. create-bgp-peer

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

Das folgende Codebeispiel zeigt die Verwendung. create-connection

AWS CLI

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

Mit dem folgenden create-connection Befehl wird eine Verbindung von Ihrem Netzwerk zu einem AWS Direct Connect-Standort 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"
}

Das folgende Codebeispiel zeigt die Verwendung. create-direct-connect-gateway-association-proposal

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.

Das folgende Codebeispiel zeigt die Verwendung. create-direct-connect-gateway-association

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

Das folgende Codebeispiel zeigt die Verwendung. create-direct-connect-gateway

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

Das folgende Codebeispiel zeigt die Verwendung. create-interconnect

AWS CLI

Um eine Verbindung zwischen dem Netzwerk eines Partners herzustellen und AWS

Mit dem folgenden create-interconnect Befehl wird eine Verbindung zwischen dem Netzwerk eines AWS Direct Connect-Partners und einem bestimmten AWS Direct Connect-Standort hergestellt:

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

Das folgende Codebeispiel zeigt die Verwendung. create-lag

AWS CLI

Um eine LAG mit neuen Verbindungen zu erstellen

Im folgenden Beispiel wird eine LAG erstellt und zwei neue AWS Direct Connect-Verbindungen für die LAG mit einer Bandbreite von 1 Gbit/s 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"
}

  • API-Details finden Sie CreateLag in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendung. create-private-virtual-interface

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

Das folgende Codebeispiel zeigt die Verwendung. create-public-virtual-interface

AWS CLI

Um eine öffentliche virtuelle Schnittstelle zu erstellen

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

Das folgende Codebeispiel zeigt die Verwendung. create-transit-virtual-interface

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.

Das folgende Codebeispiel zeigt die Verwendung. delete-bgp-peer

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

Das folgende Codebeispiel zeigt die Verwendung. delete-connection

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

Das folgende Codebeispiel zeigt die Verwendung. delete-direct-connect-gateway-association

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.

Das folgende Codebeispiel zeigt die Verwendung. delete-direct-connect-gateway

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

Das folgende Codebeispiel zeigt die Verwendung. delete-interconnect

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

Das folgende Codebeispiel zeigt die Verwendung. delete-lag

AWS CLI

Um eine LAG zu löschen

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

  • API-Details finden Sie DeleteLag in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendung. delete-virtual-interface

AWS CLI

Um eine virtuelle Schnittstelle zu löschen

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

Das folgende Codebeispiel zeigt die Verwendung. describe-connection-loa

AWS CLI

Um Ihre LOA-CFA für eine Verbindung mit Linux oder Mac OS X zu beschreiben

Das folgende Beispiel beschreibt Ihre LOA-CFA Verbindungdxcon-fh6ayh1d. Der Inhalt von ist Base64-kodiert. LOA-CFA 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

Um Ihre LOA-CFA für eine Verbindung mit Windows zu beschreiben

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 for-Verbindung dxcon-fh6ayh1d und verwendet die --query Parameter --output und, um die Ausgabe zu steuern und den Inhalt der loaContent Struktur in eine Datei mit dem Namen zu extrahierenmyLoaCfa.base64. 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 zur Steuerung der AWS CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle im Benutzerhandbuch zur AWS Befehlszeilenschnittstelle.

Das folgende Codebeispiel zeigt die Verwendung. describe-connections-on-interconnect

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

Das folgende Codebeispiel zeigt die Verwendungdescribe-connections.

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

Das folgende Codebeispiel zeigt die Verwendung. describe-direct-connect-gateway-association-proposals

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.

Das folgende Codebeispiel zeigt die Verwendung. describe-direct-connect-gateway-associations

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

Das folgende Codebeispiel zeigt die Verwendung. describe-direct-connect-gateway-attachments

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

Das folgende Codebeispiel zeigt die Verwendung. describe-direct-connect-gateways

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

Das folgende Codebeispiel zeigt die Verwendung. describe-hosted-connections

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

Das folgende Codebeispiel zeigt die Verwendung. describe-interconnect-loa

AWS CLI

Um Ihre LOA-CFA für eine Verbindung mit Linux oder Mac OS X zu beschreiben

Das folgende Beispiel beschreibt Ihre LOA-CFA für dxcon-fh6ayh1d Interconnect. Der Inhalt von ist LOA-CFA 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

Um Ihre LOA-CFA für eine Verbindung mit Windows zu beschreiben

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 Ihren LOA-CFA für Interconnect dxcon-fh6ayh1d und verwendet die --query Parameter --output und, um die Ausgabe zu steuern und den Inhalt der loaContent Struktur in eine Datei mit dem Namen zu extrahieren. myLoaCfa.base64 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 zur Steuerung der AWS CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle im Benutzerhandbuch zur AWS Befehlszeilenschnittstelle.

Das folgende Codebeispiel zeigt die Verwendung. describe-interconnects

AWS CLI

So listen Sie Interconnect-Verbindungen auf

Der folgende describe-interconnects Befehl listet die 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"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendung. describe-lags

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

Das folgende Codebeispiel zeigt die Verwendung. describe-loa

AWS CLI

Um Ihre LOA-CFA für eine Verbindung mit Linux oder Mac OS X zu beschreiben

Das folgende Beispiel beschreibt Ihre LOA-CFA Verbindungdxcon-fh6ayh1d. Der Inhalt von ist Base64-kodiert. LOA-CFA 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

Um Ihre LOA-CFA für eine Verbindung mit Windows zu beschreiben

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 for-Verbindung dxcon-fh6ayh1d und verwendet die --query Parameter --output und, um die Ausgabe zu steuern und den Inhalt der loaContent Struktur in eine Datei mit dem Namen zu extrahierenmyLoaCfa.base64. 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 zur Steuerung der AWS CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle im Benutzerhandbuch zur AWS Befehlszeilenschnittstelle.

  • Einzelheiten zur API finden Sie DescribeLoa in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendung. describe-locations

AWS CLI

Um AWS Direct Connect-Partner und -Standorte aufzulisten

Mit dem folgenden describe-locations Befehl werden AWS Direct Connect-Partner und -Standorte in der aktuellen Region aufgelistet:

aws directconnect describe-locations

Ausgabe:

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

Das folgende Codebeispiel zeigt die Verwendungdescribe-tags.

AWS CLI

Um die Tags für Ihre AWS Direct Connect-Ressourcen zu beschreiben

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

  • Einzelheiten zur API finden Sie DescribeTags in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendung. describe-virtual-gateways

AWS CLI

So listen Sie Virtual Private Gateways auf

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

aws directconnect describe-virtual-gateways

Ausgabe:

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

Das folgende Codebeispiel zeigt die Verwendung. describe-virtual-interfaces

AWS CLI

So listen Sie alle virtuellen Schnittstellen auf

Der folgende describe-virtual-interfaces Befehl listet die Informationen zu allen virtuellen Schnittstellen auf, die mit Ihrem AWS Konto verknüpft 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"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendung. disassociate-connection-from-lag

AWS CLI

Um eine Verbindung zu einer LAG zu trennen

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

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

So fügen Sie einer AWS Direct Connect-Ressource 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"

  • API-Details finden Sie TagResource in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

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

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

Das folgende Codebeispiel zeigt die Verwendung. update-direct-connect-gateway-association

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.

Das folgende Codebeispiel zeigt die Verwendung. update-lag

AWS CLI

Um eine LAG zu aktualisieren

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

  • API-Details finden Sie UpdateLag in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendung. update-virtual-interface-attributes

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.