创建TT
仅当您的服务中断或丢失时需要立即响应的请求才应提交故障单。对于所有其他请求，请提交Smart Hands请求。如果丢失或中断由 Equinix 引起，它将被视为“因 Equinix 造成”，不会引起任何费用。但是，如果问题不是由Equinix引起的，将收取正常的Smart Hands费用。
要帮助您决定提交哪个请求，请参阅决定是创建Smart Hands还是TT。
识别问题并获取资产参考
要打开故障代码，您需要识别相应的故障代码，并确定 要在请求正文中提交的相关资产参考。如果您已经知道代码和资产引用，则可以跳过此步骤。
您必须具有与故障单订购权限相对应的安装基础查看权限。
将为请求主体的参数传递故障票据代码code。
接下来，检索所需资产参考的主要和次要参考标识符。有关如何检索主要和次要ID值的说明，请参阅How to Retrieve Assets (如何检索资产)。
这些值将传递给请求正文中的primaryId和secondaryId参数。
例如，如果问题子类别"经历全面断电"最能代表您遇到的问题，则您需要的故障单代码为"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 请求示例：
票据至少需要提供以下参数：代码，说明，主ID，OccurredDateTime。 如果未特别提供技术和通知联系人，则默认为订购联系人(经过身份验证的用户)。
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且返回响应标头时，将成功创建故障单。没有响应主体。
如果您要检索，更新，添加注释或取消此TT，请参阅API参考部分中的TT (V2)以了解更多信息。