View a markdown version of this page

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

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

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.

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 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 distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

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

AWS CLI

Aceptación de una propuesta de asociación de puerta de enlace

En la siguiente accept-direct-connect-gateway-association-proposal, se 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 Accepting or Rejecting a Transit Gateway Association Proposal en la Guía del usuario de AWS Direct Connect.

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

AWS CLI

Creación de una conexión alojada en una interconexión

El siguiente comando allocate-connection-on-interconnect 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 utilizar allocate-hosted-connection.

AWS CLI

Creación de una conexión alojada en una interconexión

En el siguiente ejemplo de allocate-hosted-connection, se 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 utilizar allocate-private-virtual-interface.

AWS CLI

Aprovisionamiento de una interfaz virtual privada

El siguiente comando allocate-private-virtual-interface aprovisiona una interfaz virtual privada para que sea propiedad de otro cliente:

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 utilizar allocate-public-virtual-interface.

AWS CLI

Aprovisionamiento de una interfaz virtual pública

El siguiente comando allocate-public-virtual-interface aprovisiona una interfaz virtual pública para que sea 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 utilizar allocate-transit-virtual-interface.

AWS CLI

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

En el siguiente ejemplo de allocate-transit-virtual-interface, se 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 Creating a Hosted Transit Virtual Interface en la Guía del usuario de AWS Direct Connect.

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

AWS CLI

Asociación de una conexión a un LAG

En el siguiente ejemplo, se asocia la conexión especificada con el LAG especificado.

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 utilizar associate-hosted-connection.

AWS CLI

Asociación de una conexión alojada a un LAG

En el siguiente ejemplo, se asocia la conexión alojada especificada con el LAG especificado.

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 utilizar associate-virtual-interface.

AWS CLI

Asociación de una interfaz virtual a una conexión

En el siguiente ejemplo, se asocia la interfaz virtual especificada con el LAG especificado. 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 utilizar confirm-connection.

AWS CLI

Confirmación de la creación de una conexión alojada en una interconexión

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

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

Salida:

{
    "connectionState": "pending"
}

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

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

AWS CLI

Aceptación de la propiedad de una interfaz virtual privada

El siguiente comando confirm-private-virtual-interface 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 utilizar confirm-public-virtual-interface.

AWS CLI

Aceptación de la propiedad de una interfaz virtual pública

El siguiente comando confirm-public-virtual-interface 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 utilizar confirm-transit-virtual-interface.

AWS CLI

Aceptación de la propiedad de una interfaz virtual de tránsito

La 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 Accepting a Hosted Virtual Interface en la Guía del usuario de AWS Direct Connect.

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

AWS CLI

Creación de una sesión de emparejamiento de BGP IPv6

En el siguiente ejemplo, se crea una sesión de emparejamiento de BGP IPv6 en una interfaz virtual privada dxvif-fg1vuj3d. Amazon asigna automáticamente las direcciones IPv6 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 obtener más información sobre la API, consulte CreateBgpPeerla Referencia de comandos.AWS CLI

En el siguiente ejemplo de código, se muestra cómo utilizar 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 obtener más información sobre la API, consulte CreateConnectionla Referencia de AWS CLI comandos.

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

AWS CLI

Creación de una propuesta para asociar la puerta de enlace de tránsito especificada con la puerta de enlace de Direct Connect especificada

En el siguiente ejemplo de create-direct-connect-gateway-association-proposal, se crea una propuesta para asociar la puerta de enlace de tránsito especificada con la puerta de enlace de 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 Creating a Transit Gateway Association Proposal en la Guía del usuario de AWS Direct Connect.

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

AWS CLI

Asociación de una puerta de enlace privada virtual con una puerta de enlace de Direct Connect

En el siguiente ejemplo, se asocia la puerta de enlace privada virtual vgw-6efe725e con la puerta de enlace Direct Connect 5f294f92-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 utilizar create-direct-connect-gateway.

AWS CLI

Creación de una puerta de enlace de Direct Connect

En el siguiente ejemplo, se crea una puerta de enlace de 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 utilizar 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 obtener más información sobre la API, consulte CreateInterconnectla Referencia de AWS CLI comandos.

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

AWS CLI

Creación de un LAG con nuevas conexiones

El siguiente ejemplo crea un LAG y solicita dos nuevas conexiones AWS Direct Connect para el 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"
}

Creación de un LAG con una conexión existente

En el siguiente ejemplo, se crea un LAG a partir de una conexión existente en su cuenta y se solicita una segunda conexión nueva para el 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 obtener más información sobre la API, consulte CreateLagla Referencia de AWS CLI comandos.

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

AWS CLI

Creación de una interfaz virtual privada

El siguiente comando create-private-virtual-interface 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 utilizar create-public-virtual-interface.

AWS CLI

Creación de una interfaz virtual pública

El siguiente comando create-public-virtual-interface 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 utilizar create-transit-virtual-interface.

AWS CLI

Creación de una interfaz virtual de tránsito

En el siguiente ejemplo de create-transit-virtual-interface, se 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 Creating a Transit Virtual Interface to the Direct Connect Gateway en la AWS Guía del usuario de AWS Direct Connect.

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

AWS CLI

Eliminación de un par BGP de una interfaz virtual

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

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 obtener más información sobre la API, consulte DeleteBgpPeerla Referencia de comandos.AWS CLI

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

AWS CLI

Para eliminar una conexión

El siguiente comando delete-connection elimina la colecció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 obtener más información sobre la API, consulte la Referencia DeleteConnectionde AWS CLI comandos.

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

AWS CLI

Eliminación de una asociación de puerta de enlace de Direct Connect

En el siguiente ejemplo de delete-direct-connect-gateway-association, se elimina la asociación de la puerta de enlace de 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 Associating and Disassociating Transit Gateways en la Guía del usuario de AWS Direct Connect.

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

AWS CLI

Eliminación de una puerta de enlace de Direct Connect

En el siguiente ejemplo, se elimina la puerta de enlace 5f294f92-bafb-4011-916d-9b0bexample de 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 utilizar delete-interconnect.

AWS CLI

Eliminación de una interconexión

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

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

Salida:

{
    "interconnectState": "deleted"
}

  • Para obtener más información sobre la API, consulte la Referencia de DeleteInterconnectcomandos AWS CLI .

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

AWS CLI

Eliminación de un LAG

En el siguiente ejemplo, se elimina el LAG especificado.

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 obtener más información sobre la API, consulte la Referencia DeleteLagde AWS CLI comandos.

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

AWS CLI

Eliminación de una interfaz virtual

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

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

Salida:

{
    "virtualInterfaceState": "deleting"
}

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

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

AWS CLI

Para describir su conexión mediante LOA-CFA Linux o Mac OS X

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

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

Para describir su conexión LOA-CFA mediante Windows

El ejemplo anterior requiere el uso de la utilidad base64 para decodificar la salida. En un equipo con Windows, puede usar certutil en su lugar. En el ejemplo siguiente, el primer comando describe su LOA-CFA conexión 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 utilidad certutil para decodificar el archivo y enviar el resultado a un archivo PDF.

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 salida AWS CLI, 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 obtener más información sobre la API, consulte DescribeConnectionLoala Referencia de AWS CLI comandos.

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

AWS CLI

Para enumerar las conexiones de una interconexión

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

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 utilizar describe-connections.

AWS CLI

Para enumerar todas las conexiones de la región actual

El siguiente comando describe-connections 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 obtener más información sobre la API, consulte la Referencia de DescribeConnectionscomandos AWS CLI .

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

AWS CLI

Descripción de sus propuestas de asociación de puerta de enlace de Direct Connect

En el siguiente ejemplo de describe-direct-connect-gateway-association-proposals, se muestran detalles sobre sus propuestas de asociación de puertas de enlace 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 Associating and Disassociating Transit Gateways en la Guía del usuario de AWS Direct Connect.

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

AWS CLI

Descripción de asociaciones de puertas de enlace de Direct Connect

En el siguiente ejemplo, se describen todas las asociaciones con una puerta de enlace de Direct Connect 5f294f92-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 utilizar describe-direct-connect-gateway-attachments.

AWS CLI

Descripción de las vinculaciones de puertas de enlace de Direct Connect

El siguiente ejemplo describe las interfaces virtuales que están vinculadas a la puerta de enlace Direct Connect 5f294f92-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 utilizar describe-direct-connect-gateways.

AWS CLI

Descripción de sus puertas de enlace de Direct Connect

En el siguiente ejemplo, se describen todas sus puertas de enlace 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 utilizar describe-hosted-connections.

AWS CLI

Para enumerar las conexiones de una interconexión

El siguiente ejemplo enumera las conexiones que se han aprovisionado en la interconexión especificada:

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 utilizar describe-interconnect-loa.

AWS CLI

Para describir su interconexión mediante Linux o LOA-CFA Mac OS X

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

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

Para describir su LOA-CFA interconexión mediante Windows

El ejemplo anterior requiere el uso de la utilidad base64 para decodificar la salida. En un equipo con Windows, puede usar certutil en su lugar. En el siguiente ejemplo, el primer comando describe su LOA-CFA interconexión 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 llamado. myLoaCfa.base64 El segundo comando utiliza la utilidad certutil para decodificar el archivo y enviar el resultado a un archivo PDF.

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 salida AWS CLI, 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 utilizar describe-interconnects.

AWS CLI

Para enumerar las interconexiones

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

aws directconnect describe-interconnects

Salida:

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

  • Para obtener más información sobre la API, consulta DescribeInterconnectsla Referencia de AWS CLI comandos.

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

AWS CLI

Descripción de sus LAG

En el siguiente comando, se describen todos los LAG 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 obtener más información sobre la API, consulte DescribeLagsla Referencia de comandos.AWS CLI

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

AWS CLI

Para describir su LOA-CFA conexión mediante Linux o Mac OS X

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

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

Para describir su conexión LOA-CFA mediante Windows

El ejemplo anterior requiere el uso de la utilidad base64 para decodificar la salida. En un equipo con Windows, puede usar certutil en su lugar. En el ejemplo siguiente, el primer comando describe su LOA-CFA conexión 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 utilidad certutil para decodificar el archivo y enviar el resultado a un archivo PDF.

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 salida AWS CLI, 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 obtener más información sobre la API, consulte DescribeLoala Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar 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 obtener más información sobre la API, consulte DescribeLocationsla Referencia de AWS CLI comandos.

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

AWS CLI

Para describir las etiquetas de sus recursos de AWS Direct Connect

El siguiente comando describe las etiquetas de la conexión dxcon-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 obtener detalles sobre la API, consulte DescribeTagsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar 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 cuenta: AWS 

aws directconnect describe-virtual-gateways

Salida:

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

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

AWS CLI

Para enumerar todas las interfaces virtuales

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

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 utilizar disassociate-connection-from-lag.

AWS CLI

Desasociar una conexión de un LAG

En el siguiente ejemplo, se desasocia la conexión especificada del LAG indicado.

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 utilizar tag-resource.

AWS CLI

Para agregar una etiqueta a un recurso de AWS Direct Connect

El siguiente comando agrega una etiqueta con una clave de Name y un valor de VAConnection a la instancia dxcon-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 obtener detalles sobre la API, consulte TagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar 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ón dxcon-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 obtener detalles sobre la API, consulte UntagResourcela Referencia de AWS CLI comandos.

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

AWS CLI

Actualización de los atributos especificados de la asociación de puertas de enlace de Direct Connect.

En el siguiente ejemplo update-direct-connect-gateway-association, se agrega el bloque de CIDR especificado a una asociación de puertas 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 Working with Direct Connect Gateways en la Guía del usuario de AWS Direct Connect.

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

AWS CLI

Actualización de un LAG

En el siguiente ejemplo, se cambia el nombre del LAG especificado.

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 obtener más información sobre la API, consulte la Referencia UpdateLagde AWS CLI comandos.

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

AWS CLI

Actualización de la MTU de una interfaz virtual

En el siguiente ejemplo update-virtual-interface-attributes, se actualiza la MTU de 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 Setting Network MTU for Private Virtual Interfaces or Transit Virtual Interfaces en la Guía del usuario de AWS Direct Connect.