# 创建Cross Connect 订单 Cross Connect是同一或不同Equinix IBX数据中心内的两个客户之间的点对点电缆链路。只有拥有Cross Connect和设施内电缆订购权限的客户门户网站用户才能订购Cross Connects。 此方法将在同一或不同IBX网点的两位Equinix客户(A侧和Z侧)之间创建Cross Connects订单请求。A侧客户发起此请求,以连接到Z侧提供商。 单个请求中可以订购单个或多个数量的Cross Connects。多数量Cross Connects仅能在满足以下条件的订单请求中提交: * 所有Cross Connect都从相同的 A 侧IBX、机笼和帐户开始 * 所有Cross Connect都终止于同一个 Z 侧提供商、 IBX和机笼 * 一次请求中的Cross Connect总数不超过 10 如果您想要订购的Cross Connect不符合此标准,则需要提交单独的订购请求。 ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. 身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 ### A侧信息[​](#a侧信息 "直接链接至A侧信息") 1. 使用[获取位置](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md)端点作为Cross Connect起点的位置信息(A侧)。确定确切的IBX,机笼ID和机柜ID。确保您所需的所有Cross Connects都属于同一个IBX和机笼。 如果您想为此Cross Connect接线设备,您的请求中将传递机柜ID,以获取以下A侧参数:`cabinetId`。 如果您已经知道 A 面的位置信息,则可以跳过此步骤。 2. 使用[获取连接服务](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md)检索首选网点的所有连接服务信息。确定所选IBX中可用的连接服务,媒体类型,连接器类型和协议类型。 请求主体中也将传递以下A侧参数的这些值:`connectionService`,`mediaType` `connectorType`,`protocolType`。 如果您已经知道 A 边的连接服务信息,则可以跳过此步骤。 3. 使用[获取配线架](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md)来确定A侧的首选配线架ID。请求主体中将传递以下A侧参数(patchPan 对象):`id`。 您想获取有关配线架的更多信息,例如可用端口及其所有连接服务,请参阅API参考部分下的[获取配线架{patchPanelId}](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/retrieve%20patch%20panel%20details.md)。 如果您已经知道配线架信息,则可以跳过此步骤。 ### Z侧信息[​](#z侧信息 "直接链接至Z侧信息") 1. 使用[获取提供商](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/retrieve%20list%20of%20providers.md)端点检索可用z端服务提供商列表并确定其账号。 2. 使用[获取位置](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md)端点Cross Connect目标的位置信息(z侧)。确定确切的IBX,机笼ID和机柜ID。确保您所需的所有Cross Connects都属于同一个IBX和机笼。 3. 使用[获取连接服务](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md)检索首选网点的所有连接服务信息。确定所选IBX中可用的连接服务,媒体类型,连接器类型和协议类型。 请求主体中将传递以下z端参数的这些值:`connectorType`。 4. 使用[获取配线架](https://docs.equinix.com/zh-Hans/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md)来确定A侧的首选配线架ID。请求主体中将传递以下A侧参数(patchPan 对象):`id`。 5. 请向您的服务提供商咨询其电路ID电缆参考编号。该值将在z侧参数的请求主体中传递`circuitId`。 如果您已经知道电路 ID,则可以跳过此步骤。 ## 订购不带授权书(LOA)的标准Cross Connects[​](#订购不带授权书loa的标准cross-connects "直接链接至订购不带授权书(LOA)的标准Cross Connects") 要订购标准Cross Connect,请向端点发送`POST`请求[`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/zh-Hans/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)。 请在请求正文中指定 A 侧配线架 ID、完整的连接服务详细信息,以及 Z 侧连接器类型、电路 ID 和配线架 ID。 Details数组中的一个对象代表一个Cross Connect。订购多个Cross Connects时,请 在详情数组中传递多个对象。 ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "details": [     {       "aSide": {         "connectionService": "SINGLE_MODE_FIBER",         "mediaType": "SINGLE_MODE_FIBER",         "protocolType": "10_GIG_ETHERNET",         "connectorType": "FC",         "patchPanel": {           "id": "CP:0104:1199890"         }       },       "zSide": {         "connectorType": "LC",         "circuitId": "1-12312312",         "patchPanel": {           "id": "PP:0104:1190123"         }       }     }   ] }' ``` 请求正文中包含的参数特定于此示例。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)。 ## 订购标准Cross Connect器,附带 LOA[​](#订购标准cross-connect器附带-loa "直接链接至订购标准Cross Connect器,附带 LOA") 要订购标准Cross Connect,请向端点发送`POST`请求[`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/zh-Hans/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)。 请在请求正文中指定 A 侧配线架 ID、完整的连接服务详细信息,以及 Z 侧连接器类型、电路 ID、配线架 ID 和 LOA 附件 ID。 Details数组中的一个对象代表一个Cross Connect。订购多个Cross Connects时,请 在详情数组中传递多个对象。 创建带有附件的订单之前,请使用[POST附件文件](https://docs.equinix.com/zh-Hans/api-catalog/attachmentsv1/attachments/createattachment.md)端点。 cURL 请求示例: ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "details": [     {       "aSide": {         "connectionService": "SINGLE_MODE_FIBER",         "mediaType": "SINGLE_MODE_FIBER",         "protocolType": "10_GIG_ETHERNET",         "connectorType": "FC",         "patchPanel": {           "id": "CP:0104:1199890"         }       },       "zSide": {         "providerName": "Acme Corporation",         "ibx": "AM1",         "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba"       }     }   ] }' ``` 请求正文中包含的参数特定于此示例。参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)。 ## 标准Cross Connect的完整示例[​](#标准cross-connect的完整示例 "直接链接至标准Cross Connect的完整示例") 要订购标准Cross Connect,请向端点发送`POST`请求[`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/zh-Hans/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)。 此示例为加急订单,涉​​及从包含多个账户的账户到新服务提供商的交叉连接,并附有授权书及其他附件。 信息和请求。 创建带有附件的订单之前,请使用[POST附件文件](https://docs.equinix.com/zh-Hans/api-catalog/attachmentsv1/attachments/createattachment.md)端点。 cURL 请求示例: ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "details": [     {       "aSide": {         "connectionService": "SINGLE_MODE_FIBER",         "mediaType": "SINGLE_MODE_FIBER",         "protocolType": "10_GIG_ETHERNET",         "connectorType": "FC",         "mediaConverterRequired": false,         "ifcCircuitCount": 2,         "patchPanel": {           "id": "CP:0104:1199890",           "portA": 12,           "portB": 13         },         "patchEquipment": {           "cabinetId": "SG1:01:00EQ00:0001",           "connectorType": "FC",           "details": "Refer to attachment for patching details.",           "port": 10         }       },       "zSide": {         "providerName": "Acme Corporation",         "ibx": "PE2",         "connectorType": "LC",         "circuitId": "1-12312312",         "patchPanel": {           "id": "PP:0104:1190123",           "portA": 1,           "portB": 2         },         "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba",         "notificationEmail": "johndoe@acme.com"       },       "verifyLink": true,       "circuitDeliveryDate": "2020-10-09T10:00:22.395Z",       "submarineEngineerRequired": true     }   ],   "expediteDateTime": "2020-10-10T06:30:22.395Z",   "customerReferenceId": "EQX_CC_20201010",   "description": "Please refer to attachment for full details for this cross connects order.",   "attachments": [     {       "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",       "name": "OrderInstructions.docx"     }   ],   "purchaseOrder": {     "type": "NEW",     "number": "EQXPO_Ref9654284",     "amount": 10000,     "startDate": "2020-10-01",     "endDate": "2021-09-30",     "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"   },   "contacts": [     {       "type": "NOTIFICATION",       "registeredUsers": [         "john_doe",         "john_doe1"       ]     },     {       "type": "TECHNICAL",       "firstName": "Jane",       "lastName": "Doe",       "availability": "WORK_HOURS",       "timezone": "America/New_York",       "details": [         {           "type": "EMAIL",           "value": "janedoe@acme.com"         },         {           "type": "PHONE",           "value": "+1-987654321"         },         {           "type": "MOBILE",           "value": "+1-912345678"         }       ]     }   ] }' ``` 参数及其说明的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)。