Direct Connect Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

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 mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine 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 Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie Sieaccept-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungallocate-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 Verwendungallocate-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 Verwendungallocate-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 Verwendungallocate-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungassociate-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 Verwendungassociate-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 Verwendungassociate-virtual-interface.

AWS CLI

Um eine virtuelle Schnittstelle mit einer Verbindung zu verknüpfen

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 Verwendungconfirm-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 Verwendungconfirm-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 Verwendungconfirm-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 Verwendungconfirm-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungcreate-bgp-peer.

AWS CLI

Um eine IPv6 BGP-Peering-Sitzung zu erstellen

Das folgende Beispiel erstellt eine IPv6 BGP-Peering-Sitzung auf einer privaten virtuellen Schnittstelle. dxvif-fg1vuj3d Die IPv6 Peer-Adressen werden automatisch von Amazon 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"
  }
}

  • Einzelheiten zur API finden Sie CreateBgpPeerin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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"
}

  • Einzelheiten zur API finden Sie CreateConnectionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 Verwendungcreate-direct-connect-gateway.

AWS CLI

So erstellen Sie ein Direct Connect Gateway

Das folgende Beispiel erstellt ein Direct-Connect-Gateway mit dem Namen DxGateway1.

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 Verwendungcreate-interconnect.

AWS CLI

Um eine Verbindung zwischen dem Netzwerk eines Partners herzustellen und AWS

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

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 Verwendungcreate-lag.

AWS CLI

Um eine LAG mit neuen Verbindungen zu erstellen

Das folgende Beispiel erstellt eine LAG und fordert zwei neue AWS Direct Connect-Verbindungen für die LAG mit einer Bandbreite von 1 Gbit/s an.

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

  • Einzelheiten zur API finden Sie CreateLagin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-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 Verwendungcreate-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 Verwendungcreate-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungdelete-bgp-peer.

AWS CLI

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

Das folgende Beispiel löscht den IPv6 BGP-Peer aus der virtuellen Schnittstelle. dxvif-fg1vuj3d

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

  • Einzelheiten zur API finden Sie DeleteConnectionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungdelete-direct-connect-gateway.

AWS CLI

So löschen Sie ein Direct-Connect-Gateway

Das folgende Beispiel löscht das Direct-Connect-Gateway 5f294f92-bafb-4011-916d-9b0bexample.

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 Verwendungdelete-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 Verwendungdelete-lag.

AWS CLI

Um eine LAG zu löschen

Das folgende Beispiel löscht die angegebene LAG.

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

  • Einzelheiten zur API finden Sie DeleteLagin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-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 Verwendungdescribe-connection-loa.

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 zur Steuerung der AWS CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle.

Das folgende Codebeispiel zeigt die Verwendungdescribe-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 Verwendungdescribe-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungdescribe-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 Verwendungdescribe-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 Verwendungdescribe-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 Verwendungdescribe-hosted-connections.

AWS CLI

So listen Sie Verbindungen über eine Interconnect-Verbindung auf

Das folgende Beispiel listet die Verbindungen auf, 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 Verwendungdescribe-interconnect-loa.

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 zur Steuerung der AWS CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle.

Das folgende Codebeispiel zeigt die Verwendungdescribe-interconnects.

AWS CLI

So listen Sie Interconnect-Verbindungen auf

Der folgende describe-interconnects Befehl listet die Interconnects 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 Verwendungdescribe-lags.

AWS CLI

Um deine zu beschreiben 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"
      }
  ]
}

  • Einzelheiten zur API finden Sie DescribeLagsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-loa.

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 zur Steuerung der AWS CLI-Ausgabe finden Sie unter Steuern der Befehlsausgabe über die AWS Befehlszeilenschnittstelle im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle.

  • Einzelheiten zur API finden Sie DescribeLoaunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-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 aufgeführt:

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 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 DescribeTagsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-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 Verwendungdescribe-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 Verwendungdisassociate-connection-from-lag.

AWS CLI

Um eine Verbindung von 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"

  • Einzelheiten zur API finden Sie TagResourcein 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

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-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 zuAWS Direct Connect.

Das folgende Codebeispiel zeigt die Verwendungupdate-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"
}

  • Einzelheiten zur API finden Sie UpdateLagin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-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 zuAWS Direct Connect.