创建Cross Connect 订单
Cross Connect是指同一或不同Equinix IBX数据中心内两个客户之间的点对点电缆链路。只有拥有Cross Connect和设施内电缆订购权限的客户门户用户才能订购Cross Connect。
此方法在位于相同或不同IBX位置的两个Equinix客户（A 端和 Z 端）之间创建Cross Connect订单请求。A 端客户发起此请求以连接到 Z 端提供商。
一次申请即可订购单件或多件Cross Connect件。多件Cross Connect件需满足以下条件，方可在同一订单申请中提交：
- 所有Cross Connect都从相同的 A 侧IBX、机笼和帐户开始
- 所有Cross Connect都终止于同一个 Z 侧提供商、 IBX和机笼
- 一次请求中的Cross Connect总数不超过 10
如果您想要订购的Cross Connect不符合此标准，则需要提交单独的订购请求。
先决条件
- 身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 身份验证。请参阅API身份验证以获取有关如何调用OAuth API来验证和认证您的凭据的说明。
A面信息
-
使用 GET Locations%20Locations%20%20permission%20code）端点位置信息，用于指定交叉连接（A 侧）的起始点。确定确切的 IBX、机柜 ID 和机柜 ID。确保所有需要的交叉连接都属于同一个 IBX 和机柜。
如果您想为该交叉连接修补您的设备，则机柜 ID 将作为以下 a 侧参数传递给您的请求：
cabinetId。如果您已经知道 A 面的位置信息，则可以跳过此步骤。
-
使用 GET 连接服务%20list%20个%20connection%使用 20 项服务）检索您首选位置的所有连接服务信息。确定所选 IBX 中可用的连接服务、介质类型、连接器类型和协议类型。
这些值也会在请求正文中传递给以下 a-side 参数：
connectionService、mediaType、connectorType、protocolType。如果您已经知道 A 边的连接服务信息，则可以跳过此步骤。
-
使用 GET PatchPanels%20all%使用
20patch%20panels来确定 A 面的首选配线架 ID。此值将作为以下 A 面参数（patchPanel的一部分）传递到请求正文中。 对象）：id。如果您想获取有关配线架的更多信息，例如可用端口及其所有连接服务，请参阅 GET PatchPanels {patchPanelId}。%20patch%20panel%20details) 在 API 参考部分。
如果您已经知道配线架信息，则可以跳过此步骤。
Z 侧信息
-
使用 GET 提供程序%20list%20of%20providers) 端点，用于检索可用的 z 端服务提供商列表并确定其账号。
-
使用 GET Locations%20Locations%20%20permission%20code）端点是交叉连接（z侧）目标位置信息。确定确切的IBX、机柜ID和机柜ID。确保所有所需的交叉连接都属于同一个IBX和机柜。
-
使用 GET 连接服务%20list%20个%20connection%使用 20 项服务）检索您首选位置的所有连接服务信息。确定所选 IBX 中可用的连接服务、介质类型、连接器类型和协议类型。
这些值将作为以下 z 端参数
connectorType传递到请求正文中。 -
使用 GET PatchPanels%20all%使用
20patch%20panels来确定 A 面的首选配线架 ID。此值将作为以下 A 面参数（patchPanel的一部分）传递到请求正文中。 对象）：id。 -
请向您的服务提供商咨询其电路 ID 电缆参考编号。此值将作为 z 端参数
circuitId传递到请求正文中。如果您已经知道电路 ID，则可以跳过此步骤。
订购标准Cross Connect器，无需 LOA
要订购标准交叉连接，请向 /colocations/v2/orders/crossConnects 发送 POST 请求。%20cross%20connects）端点。
请在请求正文中指定 A 侧配线架 ID、完整的连接服务详细信息，以及 Z 侧连接器类型、电路 ID 和配线架 ID。
details 数组中的每个对象代表一个交叉连接。订购多个交叉连接时，请传递 details 数组中包含多个对象。
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-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 参考。%20cross%20个连接）。
订购标准Cross Connect器，附带 LOA
要订购标准交叉连接，请向 /colocations/v2/orders/crossConnects 发送 POST 请求。%20cross%20connects）端点。
请在请求正文中指定 A 侧配线架 ID、完整的连接服务详细信息，以及 Z 侧连接器类型、电路 ID、配线架 ID 和 LOA 附件 ID。
details 数组中的每个对象代表一个交叉连接。订购多个交叉连接时，请传递 details 数组中包含多个对象。
在创建带有附件的订单之前，请使用 POST 附件文件 端点。
cURL 请求示例：
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-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 参考。%20cross%20个连接）。
标准Cross Connect的完整示例
要订购标准交叉连接，请向 /colocations/v2/orders/crossConnects 发送 POST 请求。%20cross%20connects）端点。
此示例为加急订单，涉及从包含多个账户的账户到新服务提供商的交叉连接，并附有授权书及其他附件。 信息和请求。
在创建带有附件的订单之前，请使用 POST 附件文件 端点。
cURL 请求示例：
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-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 参考。%20cross%20个连接）。