API: conexión a AWS Direct Connect

Establezca una conexión directa de capa 2 entre sus activos de colocation IBX y sus recursos de Amazon Web Services (AWS) con Fabric y AWS Direct Connect. Utilice la API para crear la conexión desde un puerto, un dispositivo Network Edge o un Fabric Cloud Router.

Si dispone de un token de servicio proporcionado por AWS, consulte Conectarse a un destino utilizando un token de servicio.

Requisitos previos de la API

1. Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte Autenticación API para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

2. Determine la información de su cara A. Cualquiera:

   • Determine la información de sus puertos Equinix Fabric enviando una solicitud GET al punto final /fabric/v4/ports. Necesita el UUID(s) del puerto y el tipo de protocolo de enlace (DOT1Q o QINQ),

   O

   • Recupere su token o tokens de servicio del lado a enviando una solicitud GET al punto final /fabric/v4/serviceTokens. Necesitará el UUID del token. El token del lado a proporciona la información relevante para configurar el lado a de la conexión.

   O

   • Determine la información de sus dispositivos Network Edge. Compruebe sus dispositivos virtuales y clusters disponibles enviando una solicitud GET al punto final /ne/v1/devices. Necesita el UUID(s) del dispositivo. Envíe una solicitud GET al punto final /ne/v1/devices/{device_id} para obtener los datos específicos de un dispositivo. Puede elegir cualquier interfaz disponible en el dispositivo para su conexión. Si no especifica ninguna, la conexión se asignará automáticamente a la siguiente interfaz disponible.

   O

   • Determine la información de su Fabric Cloud Router. Compruebe sus enrutadores en la nube disponibles enviando una solicitud POST al punto final /fabric/v4/routers/search. Necesita el UUID del enrutador.

3. Identifique el perfil de servicio de AWS Direct Connect y la información de ubicación. Encontrará más información sobre el perfil de servicio que debe elegir en la página Visión general de AWS Direct Connect.

   • UUID de AWS Direct Connect - 69ee618d-be52-468d-bc99-00566f2dd2b9.
   • UUID de alta capacidad de AWS Direct Connect: de55ca94-df3b-4680-845f-6f7093f76bef.
   • UUID redundante de AWS Direct Connect - 8b5cbdbd-53da-4d37-9bfc-cc988eb522f1.
   • AWS Direct Connect- Redundante de alta capacidad - ed48616a-c182-40b4-a462-a78ba812e961.

   Para encontrar la información de ubicación, envíe una solicitud GET al punto final /fabric/v4/serviceProfiles/{service_profile_ID} utilizando uno de los ID de perfil de servicio de AWS Direct Connect. El objeto metros de la respuesta contiene una lista de Metros Equinix y su región AWS asociada. Necesita ambos para crear una conexión.

4. Identifique y valide su ID de cuenta de Amazon. Inicie sesión en la consola de administración de AWS y localice su número de cuenta. Consulte la [documentación de AWS para obtener instrucciones sobre cómo encontrar su número de cuenta. Envíe una solicitud POST al punto final /fabric/v4/connections/validate para verificar que su ID de cuenta de AWS puede utilizarse para crear una conexión con el perfil de servicio seleccionado en el metro dado.

Conexión desde un puerto DOT1Q

Para crear una conexión desde su puerto DOT1Q a AWS, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es EVPL_VC.

Proporcione la información de su puerto en el objeto aSide incluyendo:

• accessPoint.type as COLO
• Proporcione el UUID de su puerto a port.uuid.
• linkProtocol.type como DOT1Q.
• Proporcione el ID de la VLAN a linkProtocol.vlanTag.

Proporcione sus datos de AWS Direct Connect y los detalles de ubicación en el objeto zSide, incluidos:

• Establezca accessPoint.type como SP.
• Establezca profile.type como L2_PROFILE.
• Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
• Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
• Especifique la región de AWS asociada al Metro Equinix en sellerRegion. Esta información puede encontrarse en el punto final /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte el punto final API Prerequisites. Consulte API Prerequisites para obtener más detalles.
• Establezca authenticationKey como su ID de cuenta de AWS.

Especifique cualquier otro detalle de configuración de la conexión, incluidos ancho de banda y redundancia, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Conexión desde un puerto QINQ

Para crear una conexión desde su puerto QINQ a AWS, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es EVPL_VC.

Proporcione la información de su puerto en el objeto aSide incluyendo:

• Establezca accessPoint.type como COLO.
• Proporcione el UUID de su puerto a port.uuid.
• linkProtocol.type as QINQ
• Proporcione el ID de la etiqueta interna a linkProtocol.vlanCTag.
• Proporcione el ID de etiqueta exterior a linkProtocol.vlanSTag.

Proporcione sus datos de AWS Direct Connect y los detalles de ubicación en el objeto zSide, incluidos:

• Establezca accessPoint.type como SP.
• Establezca profile.type como L2_PROFILE.
• Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
• Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
• Especifique la región de AWS asociada al Metro Equinix en sellerRegion. Esta información puede encontrarse en el punto final /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte el punto final API Prerequisites. Consulte API Prerequisites para obtener más detalles.
• Establezca authenticationKey como su ID de cuenta de AWS.

Especifique cualquier otro detalle de configuración de la conexión, incluidos ancho de banda y redundancia, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <inner_tag_ID>,
        "vlanSTag": <outer_tag_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Conexión mediante un token de servicio

Para crear una conexión utilizando un token de servicio del lado A con AWS, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es EVPL_VC.

Proporcione su UUID de token de servicio a en el objeto aSide. El token de servicio proporciona el resto de la información necesaria para establecer la conexión.

Proporcione sus datos de AWS Direct Connect y los detalles de ubicación en el objeto zSide, incluidos:

• Establezca accessPoint.type como SP.
• Establezca profile.type como L2_PROFILE.
• Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
• Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
• Especifique la región de AWS asociada al Metro Equinix en sellerRegion. Esta información puede encontrarse en el punto final /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte el punto final API Prerequisites. Consulte API Prerequisites para obtener más detalles.
• Establezca authenticationKey como su ID de cuenta de AWS.

Especifique cualquier otro detalle de configuración de la conexión, incluidos ancho de banda y redundancia, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "serviceToken": {
      "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Conexión desde un dispositivo Network Edge

Para crear una conexión desde su dispositivo Network Edge a AWS, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es EVPL_VC.

Defina su dispositivo Network Edge en el objeto aSide incluyendo:

• accessPoint.type as VD
• virtualDevice.type as EDGE
• virtualDevice.uuid as your device's UUID

Proporcione sus datos de AWS Direct Connect y los detalles de ubicación en el objeto zSide, incluidos:

• Establezca accessPoint.type como SP.
• Establezca profile.type como L2_PROFILE.
• Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
• Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
• Especifique la región de AWS asociada al Metro Equinix en sellerRegion. Esta información puede encontrarse en el punto final /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte el punto final API Prerequisites. Consulte API Prerequisites para obtener más detalles.
• Establezca authenticationKey como su ID de cuenta de AWS.

Especifique cualquier otro detalle de configuración de la conexión, incluidos ancho de banda y redundancia, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<device_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Conexión desde un Fabric Cloud Router

Para crear una conexión desde su Fabric Cloud Router a AWS, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es IP_VC.

Defina su Fabric Cloud Router en el objeto aSide incluyendo:

• Establezca accessPoint.type como CLOUD_ROUTER.
• Establezca router.uuid como UUID de su router.

Proporcione sus datos de AWS Direct Connect y los detalles de ubicación en el objeto zSide, incluidos:

• Establezca accessPoint.type como SP.
• Establezca profile.type como L2_PROFILE.
• Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
• Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
• Especifique la región de AWS asociada al Metro Equinix en sellerRegion. Esta información puede encontrarse en el punto final /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte el punto final API Prerequisites. Consulte API Prerequisites para obtener más detalles.
• Establezca authenticationKey como su ID de cuenta de AWS

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "IP_VC",
  "name": "<your_connection_name>",
    "bandwidth": <connection_speed>,
    "redundancy": {
      "priority": "<redundancy_code>"
    },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<cloud_router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Supervisión del estado de la conexión

Envíe una solicitud GET al punto final fabric/v4/connections/{connection_id} para supervisar el estado de la conexión.

equinixStatus attribute values	providerStatus attribute values	AWS Direct Connect State	Description
PROVISIONING	PROVISIONING		Connection request has not been sent to AWS yet.
PROVISIONED	PENDING_APPROVAL	Ordering -> Requested	The connection awaits for acceptance.
PROVISIONED	PROVISIONING	Pending	Connection establishment in progress.
PROVISIONED	PROVISIONED	Pending -> Available	The connection has been accepted.