Direct Connect-Beispiele unter Verwendung der AWS CLI - AWS Command Line Interface
Aktionen

Direct Connect-Beispiele unter Verwendung der AWS CLI

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

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne 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 accept-direct-connect-gateway-association-proposal verwendet wird.

AWS CLI

So akzeptieren Sie einen Gateway-Zuordnungsvorschlag

Im folgenden accept-direct-connect-gateway-association-proposal-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie allocate-connection-on-interconnect verwendet wird.

AWS CLI

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

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

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie allocate-hosted-connection verwendet wird.

AWS CLI

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

Im folgenden allocate-hosted-connection-Beispiel 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, wie allocate-private-virtual-interface verwendet wird.

AWS CLI

So stellen Sie eine private virtuelle Schnittstelle bereit

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

aws directconnect allocate-private-virtual-interface --connection-id dxcon-ffjrkx17 --owner-account 123456789012 --new-private-virtual-interface-allocation virtualInterfaceName=PrivateVirtualInterface,vlan=1000,asn=65000,authKey=asdf34example,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30

Ausgabe:

{
    "virtualInterfaceState": "confirming",
    "asn": 65000,
    "vlan": 1000,
    "customerAddress": "192.168.1.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualInterfaceId": "dxvif-fgy8orxu",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n  <logical_connection id=\"dxvif-fgy8orxu\">\n  <vlan>1000</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
    "amazonAddress": "192.168.1.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "PrivateVirtualInterface"
}

Das folgende Codebeispiel zeigt, wie allocate-public-virtual-interface verwendet wird.

AWS CLI

So stellen Sie eine öffentliche virtuelle Schnittstelle bereit

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

aws directconnect allocate-public-virtual-interface --connection-id dxcon-ffjrkx17 --owner-account 123456789012 --new-public-virtual-interface-allocation virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,authKey=asdf34example,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}]

Ausgabe:

{
    "virtualInterfaceState": "confirming",
    "asn": 65000,
    "vlan": 2000,
    "customerAddress": "203.0.113.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualInterfaceId": "dxvif-fg9xo9vp",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [
        {
            "cidr": "203.0.113.0/30"
        },
        {
            "cidr": "203.0.113.4/30"
        }
    ],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg9xo9vp\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
    "amazonAddress": "203.0.113.1/30",
    "virtualInterfaceType": "public",
    "virtualInterfaceName": "PublicVirtualInterface"
}

Das folgende Codebeispiel zeigt, wie allocate-transit-virtual-interface verwendet wird.

AWS CLI

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

Im folgenden allocate-transit-virtual-interface-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie associate-connection-with-lag verwendet wird.

AWS CLI

So verknüpfen Sie eine Verbindung mit einer LAG

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

Befehl:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie associate-hosted-connection verwendet wird.

AWS CLI

So verknüpfen Sie eine gehostete Verbindung mit einer LAG

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

Befehl:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie associate-virtual-interface verwendet wird.

AWS CLI

So verknüpfen Sie eine virtuelle Schnittstelle mit einer Verbindung

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

Befehl:

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

Ausgabe:

{
  "virtualInterfaceState": "pending",
  "asn": 65000,
  "vlan": 123,
  "customerAddress": "169.254.255.2/30",
  "ownerAccount": "123456789012",
  "connectionId": "dxlag-ffjhj9lx",
  "addressFamily": "ipv4",
  "virtualGatewayId": "vgw-38e90b51",
  "virtualInterfaceId": "dxvif-fgputw0j",
  "authKey": "0x123pK5_VBqv.UQ3kJ4123_",
  "routeFilterPrefixes": [],
  "location": "CSVA1",
  "bgpPeers": [
      {
          "bgpStatus": "down",
          "customerAddress": "169.254.255.2/30",
          "addressFamily": "ipv4",
          "authKey": "0x123pK5_VBqv.UQ3kJ4123_",
          "bgpPeerState": "deleting",
          "amazonAddress": "169.254.255.1/30",
          "asn": 65000
      },
      {
          "bgpStatus": "down",
          "customerAddress": "169.254.255.2/30",
          "addressFamily": "ipv4",
          "authKey": "0x123pK5_VBqv.UQ3kJ4123_",
          "bgpPeerState": "pending",
          "amazonAddress": "169.254.255.1/30",
          "asn": 65000
      }
  ],
  "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgputw0j\">\n  <vlan>123</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0x123pK5_VBqv.UQ3kJ4123_</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
  "amazonAddress": "169.254.255.1/30",
  "virtualInterfaceType": "private",
  "virtualInterfaceName": "VIF1A"
}

Das folgende Codebeispiel zeigt, wie confirm-connection verwendet wird.

AWS CLI

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

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

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

Ausgabe:

{
    "connectionState": "pending"
}

Das folgende Codebeispiel zeigt, wie confirm-private-virtual-interface verwendet wird.

AWS CLI

So übernehmen Sie das Eigentum an einer privaten virtuellen Schnittstelle

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

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

Ausgabe:

{
    "virtualInterfaceState": "pending"
}

Das folgende Codebeispiel zeigt, wie confirm-public-virtual-interface verwendet wird.

AWS CLI

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

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

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

Ausgabe:

{
    "virtualInterfaceState": "verifying"
}

Das folgende Codebeispiel zeigt, wie confirm-transit-virtual-interface verwendet wird.

AWS CLI

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

Im folgenden confirm-transit-virtual-interface-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie create-bgp-peer verwendet wird.

AWS CLI

So erstellen Sie eine IPv6-BGP-Peering-Sitzung

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

Befehl:

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

Ausgabe:

{
  "virtualInterface": {
      "virtualInterfaceState": "available",
      "asn": 65000,
      "vlan": 125,
      "customerAddress": "169.254.255.2/30",
      "ownerAccount": "123456789012",
      "connectionId": "dxcon-fguhmqlc",
      "addressFamily": "ipv4",
      "virtualGatewayId": "vgw-f9eb0c90",
      "virtualInterfaceId": "dxvif-fg1vuj3d",
      "authKey": "0xC_ukbCerl6EYA0example",
      "routeFilterPrefixes": [],
      "location": "EqDC2",
      "bgpPeers": [
          {
              "bgpStatus": "down",
              "customerAddress": "169.254.255.2/30",
              "addressFamily": "ipv4",
              "authKey": "0xC_ukbCerl6EYA0uexample",
              "bgpPeerState": "available",
              "amazonAddress": "169.254.255.1/30",
              "asn": 65000
          },
          {
              "bgpStatus": "down",
              "customerAddress": "2001:db8:1100:2f0:0:1:9cb4:4216/125",
              "addressFamily": "ipv6",
              "authKey": "0xS27kAIU_VHPjjAexample",
              "bgpPeerState": "pending",
              "amazonAddress": "2001:db8:1100:2f0:0:1:9cb4:4211/125",
              "asn": 64600
          }
      ],
      "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg1vuj3d\">\n  <vlan>125</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0xC_ukbCerl6EYA0uexample</bgp_auth_key>\n  <ipv6_customer_address>2001:db8:1100:2f0:0:1:9cb4:4216/125</ipv6_customer_address>\n  <ipv6_amazon_address>2001:db8:1100:2f0:0:1:9cb4:4211/125</ipv6_amazon_address>\n  <ipv6_bgp_asn>64600</ipv6_bgp_asn>\n  <ipv6_bgp_auth_key>0xS27kAIU_VHPjjAexample</ipv6_bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
      "amazonAddress": "169.254.255.1/30",
      "virtualInterfaceType": "private",
      "virtualInterfaceName": "Test"
  }
}

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

Das folgende Codebeispiel zeigt, wie create-connection verwendet wird.

AWS CLI

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

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

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

Ausgabe:

{
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "connectionState": "requested",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

Das folgende Codebeispiel zeigt, wie create-direct-connect-gateway-association-proposal verwendet wird.

AWS CLI

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

Im folgenden create-direct-connect-gateway-association-proposal-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie create-direct-connect-gateway-association verwendet wird.

AWS CLI

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

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

Befehl:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie create-direct-connect-gateway verwendet wird.

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, wie create-interconnect verwendet wird.

AWS CLI

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

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

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie create-lag verwendet wird.

AWS CLI

So erstellen Sie eine LAG mit neuen Verbindungen

Das folgende Beispiel erstellt eine LAG und fordert zwei neue Verbindungen von AWS Direct Connect 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"
}

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

Das folgende Codebeispiel zeigt, wie create-private-virtual-interface verwendet wird.

AWS CLI

So erstellen Sie eine private virtuelle Schnittstelle

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

aws directconnect create-private-virtual-interface --connection-id dxcon-ffjrkx17 --new-private-virtual-interface virtualInterfaceName=PrivateVirtualInterface,vlan=101,asn=65000,authKey=asdf34example,amazonAddress=192.168.1.1/30,customerAddress=192.168.1.2/30,virtualGatewayId=vgw-aba37db6

Ausgabe:

{
    "virtualInterfaceState": "pending",
    "asn": 65000,
    "vlan": 101,
    "customerAddress": "192.168.1.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualGatewayId": "vgw-aba37db6",
    "virtualInterfaceId": "dxvif-ffhhk74f",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-ffhhk74f\">\n  <vlan>101</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
    "amazonAddress": "192.168.1.1/30",
    "virtualInterfaceType": "private",
    "virtualInterfaceName": "PrivateVirtualInterface"
}

Das folgende Codebeispiel zeigt, wie create-public-virtual-interface verwendet wird.

AWS CLI

So erstellen Sie eine öffentliche virtuelle Schnittstelle

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

aws directconnect create-public-virtual-interface --connection-id dxcon-ffjrkx17 --new-public-virtual-interface virtualInterfaceName=PublicVirtualInterface,vlan=2000,asn=65000,authKey=asdf34example,amazonAddress=203.0.113.1/30,customerAddress=203.0.113.2/30,routeFilterPrefixes=[{cidr=203.0.113.0/30},{cidr=203.0.113.4/30}]

Ausgabe:

{
    "virtualInterfaceState": "verifying",
    "asn": 65000,
    "vlan": 2000,
    "customerAddress": "203.0.113.2/30",
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffjrkx17",
    "virtualInterfaceId": "dxvif-fgh0hcrk",
    "authKey": "asdf34example",
    "routeFilterPrefixes": [
        {
            "cidr": "203.0.113.0/30"
        },
        {
            "cidr": "203.0.113.4/30"
        }
    ],
    "location": "TIVIT",
    "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgh0hcrk\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
    "amazonAddress": "203.0.113.1/30",
    "virtualInterfaceType": "public",
    "virtualInterfaceName": "PublicVirtualInterface"
}

Das folgende Codebeispiel zeigt, wie create-transit-virtual-interface verwendet wird.

AWS CLI

So erstellen Sie eine virtuelle Transit-Schnittstelle

Im folgenden create-transit-virtual-interface-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie delete-bgp-peer verwendet wird.

AWS CLI

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

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

Befehl:

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

Ausgabe:

{
  "virtualInterface": {
      "virtualInterfaceState": "available",
      "asn": 65000,
      "vlan": 125,
      "customerAddress": "169.254.255.2/30",
      "ownerAccount": "123456789012",
      "connectionId": "dxcon-fguhmqlc",
      "addressFamily": "ipv4",
      "virtualGatewayId": "vgw-f9eb0c90",
      "virtualInterfaceId": "dxvif-fg1vuj3d",
      "authKey": "0xC_ukbCerl6EYA0example",
      "routeFilterPrefixes": [],
      "location": "EqDC2",
      "bgpPeers": [
          {
              "bgpStatus": "down",
              "customerAddress": "169.254.255.2/30",
              "addressFamily": "ipv4",
              "authKey": "0xC_ukbCerl6EYA0uexample",
              "bgpPeerState": "available",
              "amazonAddress": "169.254.255.1/30",
              "asn": 65000
          },
          {
              "bgpStatus": "down",
              "customerAddress": "2001:db8:1100:2f0:0:1:9cb4:4216/125",
              "addressFamily": "ipv6",
              "authKey": "0xS27kAIU_VHPjjAexample",
              "bgpPeerState": "deleting",
              "amazonAddress": "2001:db8:1100:2f0:0:1:9cb4:4211/125",
              "asn": 64600
          }
      ],
      "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fg1vuj3d\">\n  <vlan>125</vlan>\n  <customer_address>169.254.255.2/30</customer_address>\n  <amazon_address>169.254.255.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>0xC_ukbCerl6EYA0example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
      "amazonAddress": "169.254.255.1/30",
      "virtualInterfaceType": "private",
      "virtualInterfaceName": "Test"
  }
}

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

Das folgende Codebeispiel zeigt, wie delete-connection verwendet wird.

AWS CLI

So löschen Sie eine Verbindung

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

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

Ausgabe:

{
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-fg31dyv6",
    "connectionState": "deleted",
    "bandwidth": "1Gbps",
    "location": "TIVIT",
    "connectionName": "Connection to AWS",
    "region": "sa-east-1"
}

Das folgende Codebeispiel zeigt, wie delete-direct-connect-gateway-association verwendet wird.

AWS CLI

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

Im folgenden delete-direct-connect-gateway-association-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie delete-direct-connect-gateway verwendet wird.

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, wie delete-interconnect verwendet wird.

AWS CLI

So löschen Sie eine Interconnect-Verbindung

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

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

Ausgabe:

{
    "interconnectState": "deleted"
}

Das folgende Codebeispiel zeigt, wie delete-lag verwendet wird.

AWS CLI

So löschen Sie eine LAG

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

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

Das folgende Codebeispiel zeigt, wie delete-virtual-interface verwendet wird.

AWS CLI

So löschen Sie eine virtuelle Schnittstelle

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

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

Ausgabe:

{
    "virtualInterfaceState": "deleting"
}

Das folgende Codebeispiel zeigt, wie describe-connection-loa verwendet wird.

AWS CLI

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

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

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

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

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

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

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

Das folgende Codebeispiel zeigt, wie describe-connections-on-interconnect verwendet wird.

AWS CLI

So listen Sie Verbindungen über eine Interconnect-Verbindung auf

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

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie describe-connections verwendet wird.

AWS CLI

So listen Sie alle Verbindungen in der aktuellen Region auf

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

aws directconnect describe-connections

Ausgabe:

{
  "connections": [
      {
          "awsDevice": "EqDC2-123h49s71dabc",
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fguhmqlc",
          "lagId": "dxlag-ffrz71kw",
          "connectionState": "down",
          "bandwidth": "1Gbps",
          "location": "EqDC2",
          "connectionName": "My_Connection",
          "loaIssueTime": 1491568964.0,
          "region": "us-east-1"
      }
  ]
}

Das folgende Codebeispiel zeigt, wie describe-direct-connect-gateway-association-proposals verwendet wird.

AWS CLI

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

Im folgenden describe-direct-connect-gateway-association-proposals-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie describe-direct-connect-gateway-associations verwendet wird.

AWS CLI

So beschreiben Sie Zuordnungen des Direct-Connect-Gateways

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

Befehl:

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

Ausgabe:

{
  "nextToken": "eyJ2IjoxLCJzIjoxLCJpIjoiOU83OTFodzdycnZCbkN4MExHeHVwQT09IiwiYyI6InIxTEN0UEVHV0I1UFlkaWFnNlUxanJkRWF6eW1iOElHM0FRVW1MdHRJK0dxcnN1RWtvcFBKWFE2ZjRNRGdGTkhCa0tDZmVINEtZOEYwZ0dEYWZpbmU0ZnZMYVhKRjdXRVdENmdQZ1Y4d2w0PSJ9",
  "directConnectGatewayAssociations": [
      {
          "associationState": "associating",
          "virtualGatewayOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualGatewayId": "vgw-6efe725e",
          "virtualGatewayRegion": "us-east-2"
      },
      {
          "associationState": "disassociating",
          "virtualGatewayOwnerAccount": "123456789012",
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample",
          "virtualGatewayId": "vgw-ebaa27db",
          "virtualGatewayRegion": "us-east-2"
      }
  ]
}

Das folgende Codebeispiel zeigt, wie describe-direct-connect-gateway-attachments verwendet wird.

AWS CLI

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

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

Befehl:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie describe-direct-connect-gateways verwendet wird.

AWS CLI

So beschreiben Sie Ihre Direct-Connect-Gateways

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

Befehl:

aws directconnect describe-direct-connect-gateways

Ausgabe:

{
  "directConnectGateways": [
      {
          "amazonSideAsn": 64512,
          "directConnectGatewayId": "cf68415c-f4ae-48f2-87a7-3b52cexample",
          "ownerAccount": "123456789012",
          "directConnectGatewayName": "DxGateway2",
          "directConnectGatewayState": "available"
      },
      {
          "amazonSideAsn": 64512,
          "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bdexample",
          "ownerAccount": "123456789012",
          "directConnectGatewayName": "DxGateway1",
          "directConnectGatewayState": "available"
      }
  ]
}

Das folgende Codebeispiel zeigt, wie describe-hosted-connections verwendet wird.

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, wie describe-interconnect-loa verwendet wird.

AWS CLI

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

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

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

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

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

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

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

Das folgende Codebeispiel zeigt, wie describe-interconnects verwendet wird.

AWS CLI

So listen Sie Interconnect-Verbindungen auf

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

aws directconnect describe-interconnects

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie describe-lags verwendet wird.

AWS CLI

So beschreiben Sie Ihre LAGs

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

Befehl:

aws directconnect describe-lags

Ausgabe:

{
  "lags": [
      {
          "awsDevice": "EqDC2-19y7z3m17xpuz",
          "numberOfConnections": 2,
          "lagState": "down",
          "ownerAccount": "123456789012",
          "lagName": "DA-LAG",
          "connections": [
              {
                  "ownerAccount": "123456789012",
                  "connectionId": "dxcon-ffnikghc",
                  "lagId": "dxlag-fgsu9erb",
                  "connectionState": "requested",
                  "bandwidth": "10Gbps",
                  "location": "EqDC2",
                  "connectionName": "Requested Connection 1 for Lag dxlag-fgsu9erb",
                  "region": "us-east-1"
              },
              {
                  "ownerAccount": "123456789012",
                  "connectionId": "dxcon-fglgbdea",
                  "lagId": "dxlag-fgsu9erb",
                  "connectionState": "requested",
                  "bandwidth": "10Gbps",
                  "location": "EqDC2",
                  "connectionName": "Requested Connection 2 for Lag dxlag-fgsu9erb",
                  "region": "us-east-1"
              }
          ],
          "lagId": "dxlag-fgsu9erb",
          "minimumLinks": 0,
          "connectionsBandwidth": "10Gbps",
          "region": "us-east-1",
          "location": "EqDC2"
      }
  ]
}

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

Das folgende Codebeispiel zeigt, wie describe-loa verwendet wird.

AWS CLI

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

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

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

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

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

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

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

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

Das folgende Codebeispiel zeigt, wie describe-locations verwendet wird.

AWS CLI

So listen Sie Partner und Standorte von AWS Direct Connect auf

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

aws directconnect describe-locations

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie describe-tags verwendet wird.

AWS CLI

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

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

Befehl:

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

Ausgabe:

{
  "resourceTags": [
      {
          "resourceArn": "arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12",
          "tags": [
              {
                  "value": "VAConnection",
                  "key": "Name"
              }
          ]
      }
  ]
}

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

Das folgende Codebeispiel zeigt, wie describe-virtual-gateways verwendet wird.

AWS CLI

So listen Sie Virtual Private Gateways auf

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

aws directconnect describe-virtual-gateways

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie describe-virtual-interfaces verwendet wird.

AWS CLI

So listen Sie alle virtuellen Schnittstellen auf

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

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

Ausgabe:

{
    "virtualInterfaces": [
        {
            "virtualInterfaceState": "down",
            "asn": 65000,
            "vlan": 101,
            "customerAddress": "192.168.1.2/30",
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffjrkx17",
            "virtualGatewayId": "vgw-aba37db6",
            "virtualInterfaceId": "dxvif-ffhhk74f",
            "authKey": "asdf34example",
            "routeFilterPrefixes": [],
            "location": "TIVIT",
            "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-ffhhk74f\">\n  <vlan>101</vlan>\n  <customer_address>192.168.1.2/30</customer_address>\n  <amazon_address>192.168.1.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>private</connection_type>\n</logical_connection>\n",
            "amazonAddress": "192.168.1.1/30",
            "virtualInterfaceType": "private",
            "virtualInterfaceName": "PrivateVirtualInterface"
        },
        {
            "virtualInterfaceState": "verifying",
            "asn": 65000,
            "vlan": 2000,
            "customerAddress": "203.0.113.2/30",
            "ownerAccount": "123456789012",
            "connectionId": "dxcon-ffjrkx17",
            "virtualGatewayId": "",
            "virtualInterfaceId": "dxvif-fgh0hcrk",
            "authKey": "asdf34example",
            "routeFilterPrefixes": [
                {
                    "cidr": "203.0.113.4/30"
                },
                {
                    "cidr": "203.0.113.0/30"
                }
            ],
            "location": "TIVIT",
            "customerRouterConfig": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<logical_connection id=\"dxvif-fgh0hcrk\">\n  <vlan>2000</vlan>\n  <customer_address>203.0.113.2/30</customer_address>\n  <amazon_address>203.0.113.1/30</amazon_address>\n  <bgp_asn>65000</bgp_asn>\n  <bgp_auth_key>asdf34example</bgp_auth_key>\n  <amazon_bgp_asn>7224</amazon_bgp_asn>\n  <connection_type>public</connection_type>\n</logical_connection>\n",
            "amazonAddress": "203.0.113.1/30",
            "virtualInterfaceType": "public",
            "virtualInterfaceName": "PublicVirtualInterface"
        }
    ]
}

Das folgende Codebeispiel zeigt, wie disassociate-connection-from-lag verwendet wird.

AWS CLI

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

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

Befehl:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

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

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

Befehl:

aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tags "key=Name,value=VAConnection"

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

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

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

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

Befehl:

aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-abcabc12 --tag-keys Name

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

Das folgende Codebeispiel zeigt, wie update-direct-connect-gateway-association verwendet wird.

AWS CLI

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

Im folgenden update-direct-connect-gateway-association-Beispiel 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 zu AWS Direct Connect.

Das folgende Codebeispiel zeigt, wie update-lag verwendet wird.

AWS CLI

So aktualisieren Sie eine LAG

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

Befehl:

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

Ausgabe:

{
  "awsDevice": "CSVA1-23u8tlpaz8iks",
  "numberOfConnections": 2,
  "lagState": "down",
  "ownerAccount": "123456789012",
  "lagName": "2ConnLag",
  "connections": [
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-fflqyj95",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 2 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      },
      {
          "ownerAccount": "123456789012",
          "connectionId": "dxcon-ffqr6x5q",
          "lagId": "dxlag-ffjhj9lx",
          "connectionState": "requested",
          "bandwidth": "1Gbps",
          "location": "CSVA1",
          "connectionName": "Requested Connection 1 for Lag dxlag-ffjhj9lx",
          "region": "us-east-1"
      }
  ],
  "lagId": "dxlag-ffjhj9lx",
  "minimumLinks": 0,
  "connectionsBandwidth": "1Gbps",
  "region": "us-east-1",
  "location": "CSVA1"
}

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

Das folgende Codebeispiel zeigt, wie update-virtual-interface-attributes verwendet wird.

AWS CLI

So aktualisieren Sie die MTU für eine virtuelle Schnittstelle

Im folgenden update-virtual-interface-attributes-Beispiel 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 zu AWS Direct Connect.