# API: conexión a AWS Direct Connect Establezca una conexión directa de capa 2 entre sus activos de IBX y sus recursos de Amazon Web Services (AWS) con Fabric y AWS Direct Connect. Utilice el API para crear la conexión desde un puerto, un dispositivo Network Edge o Fabric Cloud Router. ![](https://docs.equinix.com/es/assets/images/connectToAWS-e4d5112e10b97bf9a1a7d753bf90b11b.png) Si tiene un token de servicio proporcionado por AWS, consulte [Conectarse a un destino mediante un token de servicio](https://docs.equinix.com/es/fabric/fabric-api/connect-using-service-token.md) . ## Requisitos previos de la API[​](#requisitos-previos-de-la-api "Enlace directo a 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 de API](https://docs.equinix.com/es/equinix-api/api-authentication.md) para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales. 2. Determine su información de A-Side. O bien: * Determine la información de sus puertos Equinix Fabric enviando una `GET` solicitud al [`/fabric/v4/ports`](https://docs.equinix.com/es/api-catalog/fabricv4/ports/getports.md) punto final. Necesita los UUID del puerto y el tipo de protocolo de enlace (DOT1Q o QINQ), O * Recupere su token o tokens de servicio de A-Side enviando una `GET` solicitud al [`/fabric/v4/serviceTokens`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens) punto final. Necesita el UUID del token. El token de A-Side proporciona la información relevante para configurar el A-Side de la conexión. O * Determina la información de tu dispositivo Network Edge. Compruebe sus dispositivos virtuales y clústeres disponibles enviando una `GET` solicitud al [`/ne/v1/devices`](https://docs.equinix.com/es/api-catalog/network-edgev1/virtual-device/getvirtualdevices) punto final. Necesita el UUID(s) del dispositivo. Envíe una `GET` solicitud al [`/ne/v1/devices/{device_id}`](https://docs.equinix.com/es/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid) punto final para obtener los detalles de un dispositivo. Puede elegir cualquier interfaz disponible en el dispositivo para su conexión. Si no especifica una, la conexión se asigna automáticamente a la siguiente interfaz disponible. O * Determina la información de tu Fabric Cloud Router. Compruebe sus enrutadores en la nube disponibles enviando una `POST` solicitud al [`/fabric/v4/routers/search`](https://docs.equinix.com/es/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md) punto final. Necesita el UUID del router. 3. Identifique el perfil de servicio de AWS Direct Connect y la información de ubicación. Más información sobre el perfil de servicio que debe elegir se encuentra en la página[Descripción general de AWS Direct Connect](https://docs.equinix.com/es/fabric-marketplace/connecting-to-service-provider/aws/direct-connect-overview.md). * 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 `GET` solicitud al [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) punto final utilizando uno de los IDS del perfil de servicio de AWS Direct Connect. El `metros` objeto de la respuesta contiene una lista de áreas metropolitanas de 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html) para obtener instrucciones sobre cómo encontrar su número de cuenta. Envíe una `POST` solicitud al [`/fabric/v4/connections/validate`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/validateconnections.md) punto final para verificar que su ID de cuenta de AWS se puede utilizar para crear una conexión con el perfil de servicio seleccionado en el área metropolitana correspondiente. ## Conexión desde un puerto DOT1Q[​](#conexión-desde-un-puerto-dot1q "Enlace directo a Conexión desde un puerto DOT1Q") Para crear una conexión desde su puerto DOT1Q a AWS, envíe una `POST` solicitud al [`/fabric/v4/connections`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) punto final. La conexión `type` es `EVPL_VC`. Proporcione la información de su puerto en el `aSide` objeto, incluyendo: * `accessPoint.type` as `COLO` * Proporcione el UUID de su puerto a `port.uuid` * LinkProtocol.type as `DOT1Q` * Proporcione el ID de VLAN a `linkProtocol.vlanTag` Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el `zSide` objeto, incluidos: * Establecer `accessPoint.type` como `SP`. * Establecer `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 área metropolitana de Equinix a la que se está conectando en `location.metroCode`. * Especifique la región de AWS asociada al área metropolitana de Equinix en `sellerRegion`. Esta información se puede encontrar en el [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) punto final. Consulte el punto final de[los requisitos previos de API](#api-prerequisites). Consulte los[requisitos previos de API](#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 `bandwidth` y `redundancy`, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la [referencia de API](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) . Ejemplo de solicitud cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": {      "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {         "type": "DOT1Q",         "vlanTag":       }     }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Conexión desde un puerto QINQ[​](#conexión-desde-un-puerto-qinq "Enlace directo a Conexión desde un puerto QINQ") Para crear una conexión desde su puerto de QINQ a AWS, envíe una `POST` solicitud al [`/fabric/v4/connections`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) punto final. La conexión `type` es `EVPL_VC`. Proporcione la información de su puerto en el `aSide` objeto, incluyendo: * Establecer `accessPoint.type` como `COLO` * Proporcione el UUID de su puerto a `port.uuid` * `linkProtocol.type` as `QINQ` * Proporcione el ID de etiqueta interno a `linkProtocol.vlanCTag` * Proporcione el ID de la etiqueta externa a `linkProtocol.vlanSTag` Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el `zSide` objeto, incluidos: * Establecer `accessPoint.type` como `SP`. * Establecer `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 área metropolitana de Equinix a la que se está conectando en `location.metroCode`. * Especifique la región de AWS asociada al área metropolitana de Equinix en `sellerRegion`. Esta información se puede encontrar en el [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) punto final. Consulte el punto final de[los requisitos previos de API](#api-prerequisites). Consulte los[requisitos previos de API](#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 `bandwidth` y `redundancy`, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la [referencia de API](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) . Ejemplo de solicitud cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": { "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {        "type": "QINQ",         "vlanCTag": ,         "vlanSTag":       } }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## Conexión mediante un token de servicio[​](#conexión-mediante-un-token-de-servicio "Enlace directo a Conexión mediante un token de servicio") Para crear una conexión con un token de servicio de A-Side A AWS, envíe una `POST` solicitud al [`/fabric/v4/connections`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) punto final. La conexión `type` es `EVPL_VC`. Proporcione su UUID de token de servicio en el `aSide` objeto. El token de servicio proporciona toda la información necesaria para establecer la conexión. Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el `zSide` objeto, incluidos: * Establecer `accessPoint.type` como `SP`. * Establecer `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 área metropolitana de Equinix a la que se está conectando en `location.metroCode`. * Especifique la región de AWS asociada al área metropolitana de Equinix en `sellerRegion`. Esta información se puede encontrar en el [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) punto final. Consulte el punto final de[los requisitos previos de API](#api-prerequisites). Consulte los[requisitos previos de API](#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 `bandwidth` y `redundancy`, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la [referencia de API](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) . Ejemplo de solicitud cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "serviceToken": { "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## Conexión desde un dispositivo Network Edge[​](#conexión-desde-un-dispositivo-network-edge "Enlace directo a Conexión desde un dispositivo Network Edge") Para crear una conexión desde su dispositivo Network Edge a AWS, envíe una `POST` solicitud al [`/fabric/v4/connections`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) punto final. La conexión `type` es `EVPL_VC`. Defina su dispositivo Network Edge en el `aSide` objeto, incluyendo: * `accessPoint.type` as `VD` * `virtualDevice.type` as `EDGE` * `virtualDevice.uuid` Como UUID de su dispositivo Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el `zSide` objeto, incluidos: * Establecer `accessPoint.type` como `SP`. * Establecer `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 área metropolitana de Equinix a la que se está conectando en `location.metroCode`. * Especifique la región de AWS asociada al área metropolitana de Equinix en `sellerRegion`. Esta información se puede encontrar en el [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) punto final. Consulte el punto final de[los requisitos previos de API](#api-prerequisites). Consulte los[requisitos previos de API](#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 `bandwidth` y `redundancy`, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la [referencia de API](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) . Ejemplo de solicitud cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "VD", "virtualDevice": { "type": "EDGE", "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Conexión desde un Fabric Cloud Router[​](#conexión-desde-un-fabric-cloud-router "Enlace directo a Conexión desde un Fabric Cloud Router") Para crear una conexión desde su Fabric Cloud Router a AWS, envíe una `POST` solicitud al [`/fabric/v4/connections`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnection.md) punto final. La conexión `type` es `IP_VC`. Defina su Fabric Cloud Router en el `aSide` objeto incluyendo: * Establecer `accessPoint.type` como `CLOUD_ROUTER`. * Establezca `router.uuid` como UUID de su router. Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el `zSide` objeto, incluidos: * Establecer `accessPoint.type` como `SP`. * Establecer `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 área metropolitana de Equinix a la que se está conectando en `location.metroCode`. * Especifique la región de AWS asociada al área metropolitana de Equinix en `sellerRegion`. Esta información se puede encontrar en el [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) punto final. Consulte el punto final de[los requisitos previos de API](#api-prerequisites). Consulte los[requisitos previos de API](#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 ' -d '{ "type": "IP_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "CLOUD_ROUTER", "router": { "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Supervisión del estado de la conexión[​](#supervisión-del-estado-de-la-conexión "Enlace directo a Supervisión del estado de la conexión") Envíe una `GET` solicitud al [`fabric/v4/connections/{connection_id}`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/getconnectionbyuuid.md) punto final para supervisar el estado de la conexión. | `equinixStatus` valores de atributo | `providerStatus` valores de atributo | **Estado de AWS Direct Connect** | **Descripción** | | ----------------------------------- | ------------------------------------ | -------------------------------- | ---------------------------------------------------- | | `PROVISIONING` | `PROVISIONING` | | La solicitud de conexión aún no se ha enviado a AWS. | | `PROVISIONED` | `PENDING_APPROVAL` | Pedidos -> Solicitados | La conexión espera su aceptación. | | `PROVISIONED` | `PROVISIONING` | Pendiente | Establecimiento de conexión en curso. | | `PROVISIONED` | `PROVISIONED` | Pendiente -> Disponible | La conexión ha sido aceptada. |