# API - Conexión a Microsoft Azure ExpressRoute Establezca una conexión directa de capa 2 con Microsoft Azure para acceder a Azure Cloud Infrastructure y a otros servicios de Azure Cloud. ![](https://docs.equinix.com/es/assets/images/connectToMicrosoftAzure-7cbea56c79acbe0302b172a682b43b7e.jpg) > **Nota** > > Este documento cubre la creación de una conexión desde un puerto, un token de servicio o un router en la nube en API. Para obtener información sobre cómo crear una conexión desde un dispositivo virtual, incluso en el API, consulte [Network Edge a Azure ExpressRoute](https://docs.equinix.com/es/fabric-marketplace/connecting-to-service-provider/microsoft/ne-azure-expressroute.md) ## Requisitos previos[​](#requisitos-previos "Enlace directo a Requisitos previos") 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 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 la información del perfil de servicio de Azure ExpressRoute. Más información sobre el perfil de servicio que debe elegir se encuentra en la página[Descripción general de Azure ExpressRoute](https://docs.equinix.com/es/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#azure-express-route-service-profiles). * Azure ExpressRoute - `a1390b22-bbe0-4e93-ad37-85beef9d254d` * Azure Government ExpressRoute - `0de4e413-edd7-4325-912f-7c8a4428e156` 4. Identifique y valide su clave de servicio de ExpressRoute. 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 clave de servicio de ExpressRoute se puede utilizar para crear una conexión con el perfil de servicio seleccionado en el área metropolitana indicada. ## 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 Azure ExpressRouter, 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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Establezca `authenticationKey` como su clave de servicio de ExpressRoute . * Establezca `peeringType` como `MICROSOFT` o `PRIVATE`, dependiendo de los servicios para los que esté utilizando la conexión. Para obtener más información, consulte [Configuración de emparejamiento](https://docs.equinix.com/es/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Establecer `linkProtocol.type` `QINQ`y especificar un `linkProtocol.vlanCTag`. Esto establece el ID de VLAN de ExpressRoute utilizado para emparejamiento. También puede establecer este valor en el portal de Azure después de crear la conexión. 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": "DC" }, "linkProtocol": { "type": "QINQ", "vlanCTag": }, "peeringType": "", "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 DOT1Q a Azure ExpressRouter, 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 `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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Establezca `authenticationKey` como su clave de servicio de ExpressRoute . * Establezca `peeringType` como `MICROSOFT` o `PRIVATE`, dependiendo de los servicios para los que esté utilizando la conexión. Para obtener más información, consulte [Configuración de emparejamiento](https://docs.equinix.com/es/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Establecer `linkProtocol.type` `QINQ`y especificar un `linkProtocol.vlanCTag`. Esto establece el ID de VLAN de ExpressRoute utilizado para emparejamiento. También puede establecer este valor en el portal de Azure después de crear la conexión. 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", "vlanSTag": , "vlanCTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 desde su puerto DOT1Q a Azure ExpressRouter, 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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Establezca `authenticationKey` como su clave de servicio de ExpressRoute . * Establezca `peeringType` como `MICROSOFT` o `PRIVATE`, dependiendo de los servicios para los que esté utilizando la conexión. Para obtener más información, consulte [Configuración de emparejamiento](https://docs.equinix.com/es/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Establecer `linkProtocol.type` `QINQ`y especificar un `linkProtocol.vlanCTag`. Esto establece el ID de VLAN de ExpressRoute utilizado para emparejamiento. También puede establecer este valor en el portal de Azure después de crear la conexión. 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": "" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 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 `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 Azure ExpressRoute 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 Azure ExpressRoute 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`. * Establezca `authenticationKey` como su clave de servicio de ExpressRoute . * Establezca `peeringType` como `MICROSOFT` o `PRIVATE`, dependiendo de los servicios para los que esté utilizando la conexión. Para obtener más información, consulte [Configuración de emparejamiento](https://docs.equinix.com/es/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Opcional*) Establecer `linkProtocol.type` `QINQ`y especificar un `linkProtocol.vlanCTag`. Esto establece el ID de VLAN de ExpressRoute utilizado para emparejamiento. También puede establecer este valor en el portal de Azure después de crear la conexión. 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) . ``` 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": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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/{connectionId}`](https://docs.equinix.com/es/api-catalog/fabricv4/connections/getconnectionbyuuid.md) punto final para supervisar el estado de la conexión. | Estados de conexión Equinix | | Estados de Azure | | | | --------------------------------------- | ---------------------------------------- | ------------------------ | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **`equinixStatus`** valores de atributo | **`providerStatus`** valores de atributo | **Estado del proveedor** | **Estado de emparejamientos** | **Descripción** | | `PROVISIONING` | `PROVISIONING` | No provisionado | No provisionado | Aún no se ha enviado la solicitud de conexión a Microsoft. | | `PENDING_BGP_PEERING` | `PENDING_BGP` | Aprovisionado | No provisionado | La conexión se ha aprobado y está a la espera de que el cliente configure el emparejamiento de Microsoft en el portal de Microsoft Azure. Si se conecta a Azure ExpressRoute desde un puerto, el estado permanece `PENDING_BGP_PEERING` hasta que se complete el emparejamiento en el portal de Microsoft Azure y el estado solo cambia a `PROVISIONED` una vez que Equinix Fabric se sincronice con Microsoft. Si desea sincronizar el emparejamiento de BGP al instante, utilice el punto final de API[Actions de conexión](https://docs.equinix.com/es/api-catalog/fabricv4/connections/createconnectionaction.md). Si se está conectando a Azure ExpressRoute desde un Fabric Cloud Router, también debe [configurar los detalles de enrutamiento](https://docs.equinix.com/es/fabric-cloud-router/bgp/fcr-bgp.md) para la conexión en el Equinix Customer Portal. | | `PROVISIONING` | `PROVISIONED` | | | El aprovisionamiento se ha completado en Microsoft y la conexión se está aprovisionando en Equinix. | | `PROVISIONED` | `PROVISIONED` | | | Conexión establecida. |