订购跳线拆卸

先决条件
-
身份验证 - 请提交您的用户凭据、客户端 ID 和客户端密钥以进行 OAuth2 身份验证。有关如何调用 OAuth API 来验证和确认您的凭据的说明,请参阅API 身份验证。
-
获取 Cross Connect 的序列号 - 向
/v1/assets/search端点发送POST请求,以查找正确的 Cross Connect 序列号。如果您已经知道序列号,则可以跳过此步骤。
如果找不到交叉连接器的序列号,则应使用“未找到序列号”作为序列号。
-
要获取 Smart Hands 的详细信息,您必须拥有“Smart Hands”订购权限。
-
获取 Smart Hands 订单类型 - 向
/v1/orders/smarthands/types端点发送GET请求,即可获取所有 Smart Hands 订单类型。如果您已经知道 Smart Hands 订单类型,则可以跳过此步骤。 -
获取位置信息 - 向
/v1/orders/smarthands/locations端点发送GET请求,以检索您有权访问的可用 IBX 位置。如果您已经知道位置信息,则可以跳过此步骤。
订购跳线拆除
要安排 Equinix IBX 技术人员移除跳线,请向 v1/orders/smarthands/patchCableRemoval 端点发送 POST 请求。请在请求正文中详细说明移除操作。
只有拥有Smart Hands订购权限的用户才能执行此操作。
示例 cURL,用于移除跳线,无需其他信息、附件或其他内容。 联系方式:
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/patchCableRemoval"
-H "content-type: application/json"
-H "authorization: Bearer <token>
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"cabinets": [
"AM1:0J:00JD11:0001"
],
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"crossConnects": [
{
"serialNumber": "123456789",
"deviceCabinet": "501",
"deviceConnectorType": "FC",
"deviceDetails": "Router1",
"devicePort": "1"
}
]
},
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"userName": "johndoe",
"workPhonePrefToCall": "ANYTIME"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
}
]
}'
用于移除跳线电缆的 cURL 示例,包含附加信息、附件和 联系方式:
在创建带有附件的订单之前,请调用 Attachments File 端点。
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/patchCableRemoval"
-H "content-type: application/json"
-H "authorization: Bearer <token>
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"cabinets": [
"AM1:0J:00JD11:0001"
],
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"crossConnects": [
{
"serialNumber": "123456789",
"deviceCabinet": "501",
"deviceConnectorType": "FC",
"deviceDetails": "Router1",
"devicePort": "1",
"removePatchCableWithLiveTraffic": true,
"scopeOfWork": "Refer to attachment for further instruction.",
"needSupportFromASubmarineCableStationEngineer": true
}
]
},
"attachments": [
{
"id": "fcb4a673-6308-456e-8f83-f745501d60ba",
"name": "PatchCabelRemovalInstruction.docx"
}
],
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"customerReferenceNumber": "EQX-PO2019-08-001",
"purchaseOrder": {
"purchaseOrderType": "EXEMPTED",
"attachment": {
"id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",
"name": "PurchaseOrderExemptionForm123.docx"
}
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"name": "Jane Smith",
"email": "janesmith@corporation.com",
"workPhoneCountryCode": "+44",
"workPhone": "0148211111",
"workPhonePrefToCall": "MY_BUSINESS_HOURS",
"workPhoneTimeZone": "Europe/London",
"mobilePhoneCountryCode": "+44",
"mobilePhone": "0123456789",
"mobilePhonePrefToCall": "MY_BUSINESS_HOURS",
"mobilePhoneTimeZone": "Europe/London"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
},
{
"contactType": "NOTIFICATION",
"userName": "jillsnow"
}
]
}'
有关主体参数和描述的完整列表,请参阅API 参考。
示例回答:
{
"OrderNumber": "1-457809872838"
}
响应表明订单已成功,并返回订单号。