# API - 连接到 Microsoft Azure ExpressRoute 建立与 Microsoft Azure 的直接第 2 层连接以访问 Azure 云基础设施和其他 Azure 云服务。 ![](https://docs.equinix.com/zh-Hans/assets/images/connectToMicrosoftAzure-7cbea56c79acbe0302b172a682b43b7e.jpg) > **注意** > > 本文档介绍从API中的端口,服务令牌或云路由器创建连接。有关从虚拟设备(包括在API中)创建连接的信息,请参阅[Network Edge to Azure ExpressRoute](https://docs.equinix.com/zh-Hans/fabric-marketplace/connecting-to-service-provider/microsoft/ne-azure-expressroute.md) ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. 身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 2. 确定A侧信息。以下任一项: * 向端点发送请求[`/fabric/v4/ports`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/ports/getports.md),以确定您的Equinix Fabric端口信息`GET`。端口UUID和链路协议类型(Dot1q或QinQ), 或 * 通过向端点发送请求[`/fabric/v4/serviceTokens`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens)来检索A端服务令牌`GET`。您需要令牌的UUID。A端令牌提供配置连接A端的相关信息。 或 * 确定您的Fabric Cloud Router信息。向端点发送请求[`/fabric/v4/routers/search`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md),以检查可用的云路由器`POST`。您需要路由器的UUID。 3. 识别Azure ExpressRoute服务配置文件信息。您应该选择哪种服务配置文件的详细信息,请参见[Azure ExpressRoute概述](https://docs.equinix.com/zh-Hans/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政府ExpressRoute -`0de4e413-edd7-4325-912f-7c8a4428e156` 4. 识别并验证您的ExpressRoute服务密钥。向端点发送`POST`请求[`/fabric/v4/connections/validate`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/validateconnections.md),以验证您的ExpressRoute服务密钥是否可用于在给定都会区创建与选定服务配置文件的连接。 ## 从 DOT1Q端口连接[​](#从-dot1q端口连接 "直接链接至从 DOT1Q端口连接") 要创建从您的Dot1q端口到Azure ExpressRouter的连接,请向端点发送`POST`请求[`/fabric/v4/connections`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。连接`type`为`EVPL_VC`。 在对象中提供您的端口信息`aSide`,包括: * `accessPoint.type`AS`COLO` * 将您的端口UUID提供给`port.uuid` * LinkProtocol.type AS`DOT1Q` * 将VLAN ID提供给`linkProtocol.vlanTag` 在对象中提供您的Azure ExpressRoute详细信息和位置详细信息`zSide`,包括: * 设置`accessPoint.type`为`SP`。 * 设置`profile.type`为`L2_PROFILE`。 * 在中指定您要连接的Azure ExpressRoute服务配置文件`profile.uuid`。 * 在中指定您要连接的Equinix都会区位置`location.metroCode`。 * 设置`authenticationKey`为您的ExpressRoute服务密钥。 * 设置`peeringType`为`MICROSOFT`或`PRIVATE`,具体取决于您使用该连接的服务。有关更多信息,请参阅[配置对等互连](https://docs.equinix.com/zh-Hans/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)。 * (*可选*)设置`linkProtocol.type`为`QINQ`并指定`linkProtocol.vlanCTag`。此操作将设置用于对等互连的ExpressRoute VLAN ID。您也可以在创建连接后在Azure门户中设置此值。 `redundancy`在请求正文中指定任何其他连接配置详情,包括`bandwidth`和。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。 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": [ "" ] } ] } ``` ## 从 QINQ端口连接[​](#从-qinq端口连接 "直接链接至从 QINQ端口连接") 要创建从您的Dot1q端口到Azure ExpressRouter的连接,请向端点发送`POST`请求[`/fabric/v4/connections`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。连接`type`为`EVPL_VC`。 在对象中提供您的端口信息`aSide`,包括: * `accessPoint.type`AS`COLO` * 将您的端口UUID提供给`port.uuid` * LinkProtocol.type AS`QINQ` * 向提供内部标记ID`linkProtocol.vlanCTag` * 向提供外部标记ID`linkProtocol.vlanSTag` 在对象中提供您的Azure ExpressRoute详细信息和位置详细信息`zSide`,包括: * 设置`accessPoint.type`为`SP`。 * 设置`profile.type`为`L2_PROFILE`。 * 在中指定您要连接的Azure ExpressRoute服务配置文件`profile.uuid`。 * 在中指定您要连接的Equinix都会区位置`location.metroCode`。 * 设置`authenticationKey`为您的ExpressRoute服务密钥。 * 设置`peeringType`为`MICROSOFT`或`PRIVATE`,具体取决于您使用该连接的服务。有关更多信息,请参阅[配置对等互连](https://docs.equinix.com/zh-Hans/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)。 * (*可选*)设置`linkProtocol.type`为`QINQ`并指定`linkProtocol.vlanCTag`。此操作将设置用于对等互连的ExpressRoute VLAN ID。您也可以在创建连接后在Azure门户中设置此值。 `redundancy`在请求正文中指定任何其他连接配置详情,包括`bandwidth`和。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。 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": [ "" ] } ] }' ``` ## 使用服务令牌进行连接[​](#使用服务令牌进行连接 "直接链接至使用服务令牌进行连接") 要创建从您的Dot1q端口到Azure ExpressRouter的连接,请向端点发送`POST`请求[`/fabric/v4/connections`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。连接`type`为`EVPL_VC`。 在对象中提供服务令牌UUID`aSide`。服务令牌提供建立连接所需的所有其他必要信息。 在对象中提供您的Azure ExpressRoute详细信息和位置详细信息`zSide`,包括: * 设置`accessPoint.type`为`SP`。 * 设置`profile.type`为`L2_PROFILE`。 * 在中指定您要连接的Azure ExpressRoute服务配置文件`profile.uuid`。 * 在中指定您要连接的Equinix都会区位置`location.metroCode`。 * 设置`authenticationKey`为您的ExpressRoute服务密钥。 * 设置`peeringType`为`MICROSOFT`或`PRIVATE`,具体取决于您使用该连接的服务。有关更多信息,请参阅[配置对等互连](https://docs.equinix.com/zh-Hans/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)。 * (*可选*)设置`linkProtocol.type`为`QINQ`并指定`linkProtocol.vlanCTag`。此操作将设置用于对等互连的ExpressRoute VLAN ID。您也可以在创建连接后在Azure门户中设置此值。 `redundancy`在请求正文中指定任何其他连接配置详情,包括`bandwidth`和。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。 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": [ "" ] } ] }' ``` ## 从Fabric Cloud Router连接[​](#从fabric-cloud-router连接 "直接链接至从Fabric Cloud Router连接") 要建立从Network Edge设备到AWS的连接,请向端点发送`POST`请求[`/fabric/v4/connections`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。连接`type`为`IP_VC`。 在对象中定义Fabric Cloud Router`aSide`,包括: * 设置`accessPoint.type`为`CLOUD_ROUTER`。 * 设置`router.uuid`为路由器的UUID。 在对象中提供您的Azure ExpressRoute详细信息和位置详细信息`zSide`,包括: * 设置`accessPoint.type`为`SP`。 * 设置`profile.type`为`L2_PROFILE`。 * 在中指定您要连接的Azure ExpressRoute服务配置文件`profile.uuid`。 * 在中指定您要连接的Equinix都会区位置`location.metroCode`。 * 设置`authenticationKey`为您的ExpressRoute服务密钥。 * 设置`peeringType`为`MICROSOFT`或`PRIVATE`,具体取决于您使用该连接的服务。有关更多信息,请参阅[配置对等互连](https://docs.equinix.com/zh-Hans/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)。 * (*可选*)设置`linkProtocol.type`为`QINQ`并指定`linkProtocol.vlanCTag`。此操作将设置用于对等互连的ExpressRoute VLAN ID。您也可以在创建连接后在Azure门户中设置此值。 `redundancy`在请求正文中指定任何其他连接配置详情,包括`bandwidth`和。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/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": [ "" ] } ] }' ``` ## 监控连接状态[​](#监控连接状态 "直接链接至监控连接状态") 向端点发送`GET`监控连接状态的请求[`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/getconnectionbyuuid.md)。 | Equinix 连接状态 | | Azure 状态 | | | | ----------------------------- | ------------------------------ | -------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \*\*`equinixStatus`\*\*属性值 | \*\*`providerStatus`\*\*属性值 | **提供商状态** | **Peerings状态** | **描述** | | `PROVISIONING` | `PROVISIONING` | 未配置 | 未配置 | 连接请求尚未发送给微软。 | | `PENDING_BGP_PEERING` | `PENDING_BGP` | 已配置 | 未配置 | 连接已获批,等待客户在Microsoft Azure门户网站上配置Microsoft对等互连。如果您从端口连接到Azure ExpressRoute,该状态将保持不变`PENDING_BGP_PEERING`,直至在Microsoft Azure门户中完成对等互连,且状态仅在Equinix Fabric与Microsoft同步后才会更改为`PROVISIONED`。要立即同步BGP对等互连,请使用[连接操作](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnectionaction.md)API Endpoint。如果要从Fabric Cloud Router连接到Azure ExpressRoute,还需要在Equinix Customer Portal中[配置](https://docs.equinix.com/zh-Hans/fabric-cloud-router/bgp/fcr-bgp.md)连接的[路由详细信息](https://docs.equinix.com/zh-Hans/fabric-cloud-router/bgp/fcr-bgp.md)。 | | `PROVISIONING` | `PROVISIONED` | | | 微软端配置已完成,Equinix 端正在配置连接。 | | `PROVISIONED` | `PROVISIONED` | | | 连接已建立。 |