# 连接到 Fabric 上的服务提供商 在您的IBX共置资产和服务配置文件之间建立连接。 ![](https://docs.equinix.com/zh-Hans/assets/images/connectToServiceProfile-02fcde0308ccca223457d1acfc0af2f1.png) ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. 验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 2. 确定A侧端口信息。 使用[获取所有端口](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/ports/getports.md)端点获取相关端口信息。 3. 选择Z侧都会区位置。使用[获取所有都会区](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/metros/getmetros.md)端点查找Equinix Fabric可用的所有都会区,并确定连接的目标位置。 4. 确定服务提供商的服务配置文件信息。使用“[检索服务配置文件](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/service-profiles/searchserviceprofiles.md)”端点搜索特定服务配置文件,或使用[“列出服务配置文件](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/service-profiles/listserviceprofiles.md)”端点列出所有可用的服务配置文件,并确定要连接的配置文件。 ## 创建从 DOT1Q端口到服务提供商的连接[​](#创建从-dot1q端口到服务提供商的连接 "直接链接至创建从 DOT1Q端口到服务提供商的连接") 要创建从Dot1q端口到服务提供商的连接,请向端点发送`POST`请求[`/fabric/v4/connections`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。在请求正文中指定连接的配置详情。 | | **`POST /fabric/v4/connections`** | | -------- | ------------------------------------------------------------------------------------- | | 方法 | `POST` | | 端点 | `/fabric/v4/connections` | | 标题 | `Authorization`,`Content-Type` | | 路径参数 | 不适用 | | 查询参数 | 不适用 | | 身体参数 | `type`,`name`,`order` `redundancy` `bandwidth`,,`aSide`,`zSide`,`notifications` | 在不创建连接的情况下在Production[中](https://docs.equinix.com/zh-Hans/equinix-api/testing/testing-in-production-dry-run.md)安全验证此请求,请参阅[在Production中测试(API Dry Run)](https://docs.equinix.com/zh-Hans/equinix-api/testing/testing-in-production-dry-run.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": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",         "priority": "SECONDARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "DOT1Q",                 "vlanTag": 1001             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             }         }     },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test@equinix.com"             ]         }     ] }' ``` 请求正文中包含的参数特定于此示例。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。 示例回答: ``` { "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62", "type": "EVPL_VC", "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62", "name": "Conn-1", "state": "PROVISIONING", "order": {     "purchaseOrderNumber": "1-129105284100",     "billingTier": "Up to 1 Gbps" }, "bandwidth": 1000, "redundancy": {     "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",     "priority": "SECONDARY" }, "aSide": {     "accessPoint": {         "type": "COLO",         "port": {             "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",             "type": "XF_PORT",             "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"         },         "linkProtocol": {             "type": "DOT1Q",             "vlanTag": 1001         }     } }, "zSide": {     "accessPoint": {         "type": "SP",         "profile": {             "href": "https://api.equinix.com/fabric/v4/serviceProfiles/a867f685-41b0-1b07-6de0-320a5c00abdd",             "type": "L2_Profile",             "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"         },         "location": {             "href": "https://api.equinix.com/v4/metros/SV",             "metrocode": "SV",             "region": "AMER"         }     } }, "notifications": [     {         "type": "ALL",         "emails": [             "test@equinix.com",             "test2@equinix.com"         ]     } ], "operation": {     "equinixStatus": "PENDING_APPROVAL",     "providerStatus": "NOT_AVAILABLE" }, "changeLog": {     "createdDateTime": "2021-07-15T19:30:29.526Z" } } ``` 响应负载包括在请求正文中定义的配置参数。有关可能参数及其说明的完整列表,请参阅[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。 ## 创建从 QINQ端口到服务提供商的连接[​](#创建从-qinq端口到服务提供商的连接 "直接链接至创建从 QINQ端口到服务提供商的连接") 要建立从QinQ端口到服务提供商的连接,请向端点发送`POST`请求[`/fabric/v4/connections`](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": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",         "priority": "SECONDARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "QINQ",                 "vlanCTag": 1001,                 "vlanSTag": 1002             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             }         }     },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test@equinix.com"             ]         }     ] }' ``` 请求正文中包含的参数特定于此示例。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。 ## 监控连接[​](#监控连接 "直接链接至监控连接") 使用[获取指定的连接](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/getconnectionbyuuid.md)端点监控连接状态。 | \*\*`equinixStatus`\*\*参数值 | \*\*`providerStatus`\*\*参数值 | **描述** | | ----------------------------- | ------------------------------ | ------------------------------ | | `PENDING_APPROVAL` | `NOT_AVAILABLE` | 连接请求正在等待批准。 | | `PROVISIONING`或 `REJECTED` | `NOT_AVAILABLE` | 正在建立连接或卖家已拒绝连接。 | | `PROVISIONED` | `AVAILABLE` | 连接已建立。 | ![](https://docs.equinix.com/zh-Hans/assets/images/connectToEnterpriseStatus-552bb7e1ddd9c71b8b8449c99b629842.png)