创建故障单
只有在服务中断或中断时需要立即响应的请求,才应提交故障单。对于所有其他请求,请提交Smart Hands请求。如果丢失或中断由 Equinix 引起,它将被视为“因 Equinix 造成”,不会引起任何费用。但是,如果问题并非由Equinix引起,将收取正常的Smart Hands费用。
为帮助您决定提交哪个请求,请参阅决定创建Smart Hands或故障单。

识别问题并获取资产参考
要打开故障单,您需要识别相应的故障单代码,并确定 要在请求正文中提交的相关资产参考。如果您已知道代码和资产引用,可以跳过此步骤。
您必须具有与故障单订购权限相对应的安装基础查看权限。
请求主体的参数将传递故障单代码code。
接下来,检索所需资产参考的主要和次要参考标识符。有关如何检索主要和次要ID值的说明,请参阅如何检索资产。
和secondaryId参数的这些值将在请求正文中传递primaryId。
例如,如果您面临问题子类别“遭遇总电源中断”最能代表的问题,您需要的故障单代码为"0002-0000"。您需要的主要资产参考是"Cage ID"。您还可以传递辅助资产参考,即"Cabinet ID"。
获取联系信息
确定您要包含为本次货物技术和通知联系人的用户名。这些值可以传递给registeredUsers请求主体中数组中的参数contacts。
如果您是此订购的唯一技术和通知联系人,则可以跳过此步骤。
提交一份故障单
POST /v2/ticketsView the API Reference | |
|---|---|
| Method | POST |
| URL or End Point | /v2/tickets |
| Headers | Authorization, Content-Type |
| Query Parameters | Not applicable |
| Body Parameters | code, description, primaryId, occurredDateTime, secondaryId, customerReferenceId, attachments [{id, name}], contacts [ContactRequestRegisteredUser {registeredUsers [string], type} | ContactRequestNonRegisteredUser {firstName, lastName, type, details [{type, value}]}], details {callFromCage, availability, timezone (TIME_ZONE_LIST -> string), submarineEngineerRequired} |
此方法会为已认证用户创建故障单请求。 具备故障单订购权限。
提供尽可能多的信息以加快解决问题。
cURL 请求示例:
工单至少需要提供以下参数:代码,描述,primaryId,OceredDateTime。 技术和通知联系人在未明确提供的情况下,默认为订购联系人(经过身份验证的用户)。
curl -X
POST "https://api.equinix.com/v2/tickets"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"code": "0002-0000",
"description": "The power seems to be unstable since Smart Hands cable installation from 2 days ago. Please check.",
"primaryId": "AM1:01:000111",
"occurredDateTime": "2020-08-01T03:00:24.311Z"
}'
cURL 请求示例:
这种场景与上一种场景类似,但包含了指定的技术联系人,该联系人是客户门户网站的用户。订购联系人仍是默认通知联系人。
curl -X
POST "https://api.equinix.com/v2/tickets"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"code": "0002-0000",
"description": "The power seems to be unstable since Smart Hands cable installation from 2 days ago. Please check.",
"primaryId": "AM1:01:000111",
"occurredDateTime": "2020-08-01T03:00:24.311Z",
"contacts": [
{
"registeredUsers": [
"janesmith123"
],
"type": "TECHNICAL"
}
]
}'
cURL 请求示例:
此工单包含一名未注册的技术联系人、其他通知联系人、其他资产和客户信息。 参考文献、附件和详细信息。
创建带有附件的订单之前,请致电Attachments File端点。
curl -X
POST "https://api.equinix.com/v2/tickets"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"code": "0002-0000",
"description": "The power seems to be unstable since Smart Hands cable installation from 2 days ago. Please check.",
"primaryId": "AM1:01:000111",
"occurredDateTime": "2020-08-01T03:00:24.311Z",
"secondaryId": "AM1:01:000111:0101",
"customerReferenceId": "EQX-TT-20200801",
"attachments": [
{
"id": "fcb2k8763-2947-456e-8d68-f28753d60ba",
"name": "AdditionalDetailsAttachment.docx"
}
],
"contacts": [
{
"registeredUsers": [
"janesmith123",
"jimsnow1"
],
"type": "NOTIFICATION"
},
{
"firstName": "John",
"lastName": "Doe",
"type": "TECHNICAL",
"details": [
{
"type": "PHONE",
"value": "+1-987-654-3210"
},
{
"type": "MOBILE",
"value": "+1-987-123-4567"
},
{
"type": "EMAIL",
"value": "johndoe@acmecorp.com"
}
]
}
],
"details": {
"callFromCage": true,
"availability": "WORK_HOURS",
"timezone": "America/Detroit",
"submarineEngineerRequired": true
}
}'
有关主体参数和描述的完整列表,请参阅API参考手册。
返回HTTP代码201并返回响应标头时,故障单创建成功。响应主体不存在。
要检索,更新,添加注释或取消此工单,请参阅API参考部分中的工单(V2)以获取更多信息。