AWS Direct Connect ejemplos que utilizan AWS CLI - AWS SDKEjemplos de código
Acciones

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS Direct Connect ejemplos que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with AWS Direct Connect.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usar accept-direct-connect-gateway-association-proposal.

AWS CLI

Para aceptar una propuesta de asociación de pasarelas

Lo siguiente accept-direct-connect-gateway-association-proposal acepta la propuesta especificada.

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

Para obtener más información, consulte Aceptar o rechazar una propuesta de Transit Gateway Association en la Guía del usuario de AWS Direct Connect.

En el siguiente ejemplo de código se muestra cómo usar allocate-connection-on-interconnect.

AWS CLI

Para crear una conexión alojada en una interconexión

El siguiente allocate-connection-on-interconnect comando crea una conexión alojada en una interconexión:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar allocate-hosted-connection.

AWS CLI

Para crear una conexión alojada en una interconexión

El siguiente allocate-hosted-connection ejemplo crea una conexión alojada en la interconexión especificada.

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar allocate-private-virtual-interface.

AWS CLI

Para aprovisionar una interfaz virtual privada

El siguiente allocate-private-virtual-interface comando proporciona una interfaz virtual privada que será propiedad de un cliente diferente:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar allocate-public-virtual-interface.

AWS CLI

Para aprovisionar una interfaz virtual pública

El siguiente allocate-public-virtual-interface comando proporciona una interfaz virtual pública que será propiedad de otro cliente:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar allocate-transit-virtual-interface.

AWS CLI

Para aprovisionar una interfaz virtual de tránsito que sea propiedad de la AWS cuenta especificada

El siguiente allocate-transit-virtual-interface ejemplo proporciona una interfaz virtual de tránsito para la cuenta especificada.

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

Salida:

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

Para obtener más información, consulte Creación de una interfaz virtual de tránsito alojada en la Guía del usuario de AWS Direct Connect.

En el siguiente ejemplo de código se muestra cómo usar associate-connection-with-lag.

AWS CLI

Para asociar una conexión a un LAG

El siguiente ejemplo asocia la conexión especificada a la especificadaLAG.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar associate-hosted-connection.

AWS CLI

Para asociar una conexión hospedada a un LAG

El siguiente ejemplo asocia la conexión hospedada especificada a la especificadaLAG.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar associate-virtual-interface.

AWS CLI

Para asociar una interfaz virtual a una conexión

El siguiente ejemplo asocia la interfaz virtual especificada a la especificadaLAG. Como alternativa, para asociar la interfaz virtual a una conexión, especifique el ID de una conexión de AWS Direct Connect para--connection-id, por ejemplo,dxcon-ffnikghc.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar confirm-connection.

AWS CLI

Para confirmar la creación de una conexión alojada en una interconexión

El siguiente confirm-connection comando confirma la creación de una conexión hospedada en una interconexión:

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

Salida:

{
    "connectionState": "pending"
}

  • Para API obtener más información, consulte ConfirmConnectionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar confirm-private-virtual-interface.

AWS CLI

Para aceptar la propiedad de una interfaz virtual privada

El siguiente confirm-private-virtual-interface comando acepta la propiedad de una interfaz virtual privada creada por otro cliente:

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

Salida:

{
    "virtualInterfaceState": "pending"
}

En el siguiente ejemplo de código se muestra cómo usar confirm-public-virtual-interface.

AWS CLI

Para aceptar la propiedad de una interfaz virtual pública

El siguiente confirm-public-virtual-interface comando acepta la propiedad de una interfaz virtual pública creada por otro cliente:

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

Salida:

{
    "virtualInterfaceState": "verifying"
}

En el siguiente ejemplo de código se muestra cómo usar confirm-transit-virtual-interface.

AWS CLI

Para aceptar la propiedad de una interfaz virtual de tránsito

Lo siguiente confirm-transit-virtual-interface acepta la propiedad de una interfaz virtual de tránsito creada por otro cliente.

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

Salida:

{
    "virtualInterfaceState": "pending"
}

Para obtener más información, consulte Aceptar una interfaz virtual alojada en la Guía del usuario de AWS Direct Connect.

En el siguiente ejemplo de código se muestra cómo usar create-bgp-peer.

AWS CLI

Para crear una sesión de IPv6 BGP intercambio de pares

El siguiente ejemplo crea una sesión de IPv6 BGP emparejamiento en una interfaz virtual privada. dxvif-fg1vuj3d Amazon asigna automáticamente IPv6 las direcciones homólogas.

Comando:

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

Salida:

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

  • Para API obtener más información, consulte CreateBgpPeerla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar create-connection.

AWS CLI

Para crear una conexión desde la red a una ubicación de AWS Direct Connect

El siguiente create-connection comando crea una conexión desde la red a una ubicación de AWS Direct Connect:

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

Salida:

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

  • Para API obtener más información, consulte CreateConnectionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar create-direct-connect-gateway-association-proposal.

AWS CLI

Para crear una propuesta para asociar la puerta de enlace de tránsito especificada con la puerta de enlace Direct Connect especificada

El siguiente create-direct-connect-gateway-association-proposal ejemplo crea una propuesta que asocia la puerta de enlace de tránsito especificada con la puerta de enlace Direct Connect especificada.

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

Salida:

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

Para obtener más información, consulte Creación de una propuesta de asociación de Transit Gateway en la Guía del usuario de AWS Direct Connect.

En el siguiente ejemplo de código se muestra cómo usar create-direct-connect-gateway-association.

AWS CLI

Para asociar una puerta de enlace privada virtual a una puerta de enlace Direct Connect

El siguiente ejemplo asocia la puerta de enlace privada virtual vgw-6efe725e con la puerta de enlace Direct Connect5f294f92-bafb-4011-916d-9b0bexample. Debe ejecutar el comando en la región en la que se encuentra la puerta de enlace privada virtual.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar create-direct-connect-gateway.

AWS CLI

Para crear una puerta de enlace Direct Connect

En el siguiente ejemplo, se crea una puerta de enlace Direct Connect con el nombreDxGateway1.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar create-interconnect.

AWS CLI

Para crear una interconexión entre la red de un socio y AWS

El siguiente create-interconnect comando crea una interconexión entre la red de un socio de AWS Direct Connect y una ubicación específica de AWS Direct Connect:

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

Salida:

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

  • Para API obtener más información, consulte CreateInterconnectla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar create-lag.

AWS CLI

Para crear un LAG con nuevas conexiones

El siguiente ejemplo crea LAG y solicita dos nuevas conexiones AWS Direct Connect LAG con un ancho de banda de 1 Gbps.

Comando:

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

Salida:

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

Para crear una LAG utilizando una conexión existente

En el siguiente ejemplo, se crea una LAG a partir de una conexión existente en tu cuenta y se solicita una segunda conexión nueva LAG con el mismo ancho de banda y la misma ubicación que la conexión existente.

Comando:

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

Salida:

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

  • Para API obtener más información, consulte CreateLagla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar create-private-virtual-interface.

AWS CLI

Para crear una interfaz virtual privada

El siguiente create-private-virtual-interface comando crea una interfaz virtual privada:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar create-public-virtual-interface.

AWS CLI

Para crear una interfaz virtual pública

El siguiente create-public-virtual-interface comando crea una interfaz virtual pública:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar create-transit-virtual-interface.

AWS CLI

Para crear una interfaz virtual de tránsito

El siguiente create-transit-virtual-interface ejemplo crea una interfaz virtual de tránsito para la conexión especificada.

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

Salida:

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

Para obtener más información, consulte Creación de una interfaz virtual de tránsito para la puerta de enlace Direct Connect en la Guía del usuario de AWS Direct Connect.

En el siguiente ejemplo de código se muestra cómo usar delete-bgp-peer.

AWS CLI

Para eliminar un BGP par de una interfaz virtual

En el siguiente ejemplo, se elimina el IPv6 BGP par de la interfaz dxvif-fg1vuj3d virtual.

Comando:

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

Salida:

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

  • Para API obtener más información, consulte DeleteBgpPeerla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-connection.

AWS CLI

Para eliminar una conexión

El siguiente delete-connection comando elimina la conexión especificada:

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

Salida:

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

  • Para API obtener más información, consulte DeleteConnectionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-direct-connect-gateway-association.

AWS CLI

Para eliminar una asociación de puerta de enlace de Direct Connect

El siguiente delete-direct-connect-gateway-association ejemplo elimina la asociación de la puerta de enlace Direct Connect con una puerta de enlace de tránsito que tiene el ID de asociación especificado.

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

Salida:

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

Para obtener más información, consulte Asociación y desasociación de pasarelas de tránsito en la Guía del usuario de Direct AWS Connect.

En el siguiente ejemplo de código se muestra cómo usar delete-direct-connect-gateway.

AWS CLI

Para eliminar una puerta de enlace de Direct Connect

En el siguiente ejemplo, se elimina la puerta 5f294f92-bafb-4011-916d-9b0bexample de enlace Direct Connect.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar delete-interconnect.

AWS CLI

Para eliminar una interconexión

El siguiente delete-interconnect comando elimina la interconexión especificada:

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

Salida:

{
    "interconnectState": "deleted"
}

  • Para API obtener más información, consulte la Referencia DeleteInterconnectde AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-lag.

AWS CLI

Para eliminar un LAG

En el siguiente ejemplo, se elimina lo especificadoLAG.

Comando:

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

Salida:

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

  • Para API obtener más información, consulte DeleteLagla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-virtual-interface.

AWS CLI

Para eliminar una interfaz virtual

El siguiente delete-virtual-interface comando elimina la interfaz virtual especificada:

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

Salida:

{
    "virtualInterfaceState": "deleting"
}

En el siguiente ejemplo de código se muestra cómo usar describe-connection-loa.

AWS CLI

Para describir suLOA: CFA para una conexión mediante Linux o Mac OS X

El siguiente ejemplo describe su conexión LOA - CFA fordxcon-fh6ayh1d. El contenido de LOA - CFA está codificado en base64. Este comando usa los --query parámetros --output y para controlar la salida y extraer el contenido de la estructura. loaContent La parte final del comando decodifica el contenido mediante la base64 utilidad y envía el resultado a un PDF archivo.

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

Para describir suLOA: CFA para una conexión mediante Windows

El ejemplo anterior requiere el uso de la base64 utilidad para decodificar la salida. En una computadora con Windows, puede usarla certutil en su lugar. En el ejemplo siguiente, el primer comando describe la conexión LOA - CFA for dxcon-fh6ayh1d y utiliza los --query parámetros --output y para controlar la salida y extraer el contenido de la loaContent estructura en un archivo llamadomyLoaCfa.base64. El segundo comando utiliza la certutil utilidad para decodificar el archivo y enviar el resultado a un PDF archivo.

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Para obtener más información sobre el control de la AWS CLI salida, consulte Control de la salida de comandos desde la interfaz de línea de AWS comandos en la Guía del usuario de la interfaz de línea de AWS comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-connections-on-interconnect.

AWS CLI

Para enumerar las conexiones de una interconexión

El siguiente describe-connections-on-interconnect comando muestra las conexiones que se han aprovisionado en la interconexión dada:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar describe-connections.

AWS CLI

Para ver una lista de todas las conexiones de la región actual

El siguiente describe-connections comando muestra todas las conexiones de la región actual:

aws directconnect describe-connections

Salida:

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

  • Para API obtener más información, consulte DescribeConnectionsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-direct-connect-gateway-association-proposals.

AWS CLI

Para describir sus propuestas de asociación de pasarelas Direct Connect

En el siguiente describe-direct-connect-gateway-association-proposals ejemplo, se muestran detalles sobre sus propuestas de asociación de pasarelas de Direct Connect.

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

Salida:

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

Para obtener más información, consulte Asociación y desasociación de pasarelas de tránsito en la Guía del usuario de Direct AWS Connect.

En el siguiente ejemplo de código se muestra cómo usar describe-direct-connect-gateway-associations.

AWS CLI

Para describir las asociaciones de pasarelas de Direct Connect

El siguiente ejemplo describe todas las asociaciones con la puerta de enlace Direct Connect5f294f92-bafb-4011-916d-9b0bexample.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar describe-direct-connect-gateway-attachments.

AWS CLI

Para describir los adjuntos de la puerta de enlace Direct Connect

El siguiente ejemplo describe las interfaces virtuales que están conectadas a la puerta de enlace Direct Connect5f294f92-bafb-4011-916d-9b0bexample.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar describe-direct-connect-gateways.

AWS CLI

Para describir sus pasarelas de Direct Connect

El siguiente ejemplo describe todas las pasarelas de Direct Connect.

Comando:

aws directconnect describe-direct-connect-gateways

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar describe-hosted-connections.

AWS CLI

Para enumerar las conexiones de una interconexión

En el siguiente ejemplo, se enumeran las conexiones que se han aprovisionado en la interconexión dada.

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar describe-interconnect-loa.

AWS CLI

Para describir suLOA... CFA para una interconexión mediante Linux o Mac OS X

El siguiente ejemplo describe su interconexión LOA dxcon-fh6ayh1d - CFA for. El contenido de LOA - CFA está codificado en base64. Este comando usa los --query parámetros --output y para controlar la salida y extraer el contenido de la estructura. loaContent La parte final del comando decodifica el contenido mediante la base64 utilidad y envía el resultado a un PDF archivo.

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

Para describir suLOA... CFA para una interconexión mediante Windows

El ejemplo anterior requiere el uso de la base64 utilidad para decodificar la salida. En una computadora con Windows, puede usarla certutil en su lugar. En el siguiente ejemplo, el primer comando describe la interconexión LOA - CFA for dxcon-fh6ayh1d y utiliza los --query parámetros --output y para controlar la salida y extraer el contenido de la loaContent estructura en un archivo llamadomyLoaCfa.base64. El segundo comando utiliza la certutil utilidad para decodificar el archivo y enviar el resultado a un PDF archivo.

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Para obtener más información sobre el control de la AWS CLI salida, consulte Control de la salida de comandos desde la interfaz de línea de AWS comandos en la Guía del usuario de la interfaz de línea de AWS comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-interconnects.

AWS CLI

Para enumerar las interconexiones

El siguiente describe-interconnects comando muestra las interconexiones que pertenecen a su AWS cuenta:

aws directconnect describe-interconnects

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar describe-lags.

AWS CLI

Para describir su LAGs

El siguiente comando describe todos los LAGs de la región actual.

Comando:

aws directconnect describe-lags

Salida:

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

  • Para API obtener más información, consulte DescribeLagsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-loa.

AWS CLI

Para describir suLOA: CFA para una conexión mediante Linux o Mac OS X

El siguiente ejemplo describe su conexión LOA - CFA fordxcon-fh6ayh1d. El contenido de LOA - CFA está codificado en base64. Este comando usa los --query parámetros --output y para controlar la salida y extraer el contenido de la estructura. loaContent La parte final del comando decodifica el contenido mediante la base64 utilidad y envía el resultado a un PDF archivo.

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

Para describir suLOA: CFA para una conexión mediante Windows

El ejemplo anterior requiere el uso de la base64 utilidad para decodificar la salida. En una computadora con Windows, puede usarla certutil en su lugar. En el ejemplo siguiente, el primer comando describe la conexión LOA - CFA for dxcon-fh6ayh1d y utiliza los --query parámetros --output y para controlar la salida y extraer el contenido de la loaContent estructura en un archivo llamadomyLoaCfa.base64. El segundo comando utiliza la certutil utilidad para decodificar el archivo y enviar el resultado a un PDF archivo.

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

certutil -decode myLoaCfa.base64 myLoaCfa.pdf

Para obtener más información sobre el control de la AWS CLI salida, consulte Control de la salida de comandos desde la interfaz de línea de AWS comandos en la Guía del usuario de la interfaz de línea de AWS comandos.

  • Para API obtener más información, consulte DescribeLoala Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-locations.

AWS CLI

Para enumerar los socios y las ubicaciones de AWS Direct Connect

El siguiente describe-locations comando muestra los socios y las ubicaciones de AWS Direct Connect en la región actual:

aws directconnect describe-locations

Salida:

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

  • Para API obtener más información, consulte DescribeLocationsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-tags.

AWS CLI

Para describir las etiquetas de sus recursos de AWS Direct Connect

El siguiente comando describe las etiquetas de la conexióndxcon-abcabc12.

Comando:

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

Salida:

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

  • Para API obtener más información, consulte DescribeTagsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-virtual-gateways.

AWS CLI

Para enumerar las puertas de enlace privadas virtuales

El siguiente describe-virtual-gateways comando muestra las puertas de enlace privadas virtuales que pertenecen a su AWS cuenta:

aws directconnect describe-virtual-gateways

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar describe-virtual-interfaces.

AWS CLI

Para ver una lista de todas las interfaces virtuales

El siguiente describe-virtual-interfaces comando muestra la información sobre todas las interfaces virtuales asociadas a su AWS cuenta:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar disassociate-connection-from-lag.

AWS CLI

Para desasociar una conexión de un LAG

El siguiente ejemplo desasocia la conexión especificada de la especificada. LAG

Comando:

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usar tag-resource.

AWS CLI

Para agregar una etiqueta a un recurso de AWS Direct Connect

El siguiente comando agrega una etiqueta con una clave Name y un valor de VAConnection a la conexióndxcon-abcabc12. Si el comando se ejecuta correctamente, no se muestra ningún resultado.

Comando:

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

  • Para API obtener más información, consulte TagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar untag-resource.

AWS CLI

Para eliminar una etiqueta de un recurso de AWS Direct Connect

El siguiente comando elimina la etiqueta con la clave Name de la conexióndxcon-abcabc12. Si el comando se ejecuta correctamente, no se muestra ningún resultado.

Comando:

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

  • Para API obtener más información, consulte UntagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar update-direct-connect-gateway-association.

AWS CLI

Para actualizar los atributos especificados de la asociación de pasarelas de Direct Connect

En el siguiente update-direct-connect-gateway-association ejemplo, se agrega el CIDR bloque especificado a una asociación de puerta de enlace de Direct Connect.

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

Salida:

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

Para obtener más información, consulte Uso de pasarelas de Direct Connect en la Guía del usuario de AWS Direct Connect.

En el siguiente ejemplo de código se muestra cómo usar update-lag.

AWS CLI

Para actualizar un LAG

En el siguiente ejemplo, se cambia el nombre del elemento especificadoLAG.

Comando:

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

Salida:

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

  • Para API obtener más información, consulte UpdateLagla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar update-virtual-interface-attributes.

AWS CLI

Para actualizar MTU la interfaz virtual

El siguiente update-virtual-interface-attributes ejemplo actualiza MTU la interfaz virtual especificada.

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

Salida:

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

Para obtener más información, consulte Configuración de red MTU para interfaces virtuales privadas o interfaces virtuales de tránsito en la Guía del usuario de AWS Direct Connect.