创建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不符合此标准,则需要提交单独的订购请求。
先决条件
- 身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅API验证。
A侧信息
-
使用获取位置端点作为Cross Connect起点的位置信息(A侧)。确定确切的IBX,机笼ID和机柜ID。确保您所需的所有Cross Connects都属于同一个IBX和机笼。
如果您想为此Cross Connect接线设备,您的请求中将传递机柜ID,以获取以下A侧参数:
cabinetId。如果您已经知道 A 面的位置信息,则可以跳过此步骤。
-
使用获取连接服务检索首选网点的所有连接服务信息。确定所选IBX中可用的连接服务,媒体类型,连接器类型和协议类型。
请求主体中也将传递以下A侧参数的这些值:
connectionService,mediaTypeconnectorType,protocolType。如果您已经知道 A 边的连接服务信息,则可以跳过此步骤。
-
使用获取配线架来确定A侧的首选配线架ID。请求主体中将传递以下A侧参数(patchPan 对象):
id。您想获取有关配线架的更多信息,例如可用端口及其所有连接服务,请参阅API参考部分下的获取配线架{patchPanelId}。
如果您已经知道配线架信息,则可以跳过此步骤。
Z侧信息
-
使用获取提供商端点检索可用z端服务提供商列表并确定其账号。
-
使用获取位置端点Cross Connect目标的位置信息(z侧)。确定确切的IBX,机笼ID和机柜ID。确保您所需的所有Cross Connects都属于同一个IBX和机笼。
-
使用获取连接服务检索首选网点的所有连接服务信息。确定所选IBX中可用的连接服务,媒体类型,连接器类型和协议类型。
请求主体中将传递以下z端参数的这些值:
connectorType。 -
使用获取配线架来确定A侧的首选配线架ID。请求主体中将传递以下A侧参数(patchPan 对象):
id。 -
请向您的服务提供商咨询其电路ID电缆参考编号。该值将在z侧参数的请求主体中传递
circuitId。如果您已经知道电路 ID,则可以跳过此步骤。
订购不带授权书(LOA)的标准Cross Connects
要订购标准Cross Connect,请向端点发送POST请求/colocations/v2/orders/crossConnects。
请在请求正文中指定 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 <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参考手册。
订购标准Cross Connect器,附带 LOA
要订购标准Cross Connect,请向端点发送POST请求/colocations/v2/orders/crossConnects。
请在请求正文中指定 A 侧配线架 ID、完整的连接服务详细信息,以及 Z 侧连接器类型、电路 ID、配线架 ID 和 LOA 附件 ID。
Details数组中的一个对象代表一个Cross Connect。订购多个Cross Connects时,请 在详情数组中传递多个对象。
创建带有附件的订单之前,请使用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参考手册。
标准Cross Connect的完整示例
要订购标准Cross Connect,请向端点发送POST请求/colocations/v2/orders/crossConnects。
此示例为加急订单,涉及从包含多个账户的账户到新服务提供商的交叉连接,并附有授权书及其他附件。 信息和请求。
创建带有附件的订单之前,请使用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参考手册。