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.

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

Requisitos previos

Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.
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 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 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 punto final. Necesita el UUID del router.
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áginaDescripción general de Azure ExpressRoute.
- Azure ExpressRoute - a1390b22-bbe0-4e93-ad37-85beef9d254d
- Azure Government ExpressRoute - 0de4e413-edd7-4325-912f-7c8a4428e156
Identifique y valide su clave de servicio de ExpressRoute. Envíe una POST solicitud al /fabric/v4/connections/validate 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

Para crear una conexión desde su puerto DOT1Q a Azure ExpressRouter, envíe una POST solicitud al /fabric/v4/connections 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.
(Opcional) Establecer linkProtocol.type QINQy 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 .

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": "<your_port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_id>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "DC"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <vlan_id>
      },
      "peeringType": "<peering_type>",
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}

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 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.
(Opcional) Establecer linkProtocol.type QINQy 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.

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": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanSTag": <vlan_id>,
        "vlanCTag": <vlan_id>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

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 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.
(Opcional) Establecer linkProtocol.type QINQy 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.

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": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "serviceToken": {
      "uuid": "<your_aside_service_token>"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

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 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.
(Opcional) Establecer linkProtocol.type QINQy 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.

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "IP_VC",
    "name": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

Supervisión del estado de la conexión

Envíe una GET solicitud al fabric/v4/connections/{connectionId} 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 APIActions de conexión. Si se está conectando a Azure ExpressRoute desde un Fabric Cloud Router, también debe configurar los detalles de enrutamiento 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.

Requisitos previos​

Conexión desde un puerto DOT1Q​

Conexión desde un puerto QINQ​

Conexión mediante un token de servicio​

Conexión desde un Fabric Cloud Router​

Supervisión del estado de la conexión​

Requisitos previos

Conexión desde un puerto DOT1Q

Conexión desde un puerto QINQ

Conexión mediante un token de servicio

Conexión desde un Fabric Cloud Router

Supervisión del estado de la conexión