# 创建故障单 只有在服务中断或中断时需要立即响应的请求,才应提交故障单。对于所有其他请求,请提交Smart Hands请求。如果丢失或中断由 Equinix 引起,它将被视为“因 Equinix 造成”,不会引起任何费用。但是,如果问题并非由Equinix引起,将收取正常的Smart Hands费用。 为帮助您决定提交哪个请求,请参阅[决定创建Smart Hands或故障单](https://docs.equinix.com/zh-Hans/smart-hands/sh-which-ticket.md)。 ![](https://docs.equinix.com/zh-Hans/assets/images/TroubleTicket-v2-4da756f0a4ab13b4da746eceefca894d.png) ## 识别问题并获取资产参考[​](#识别问题并获取资产参考 "直接链接至识别问题并获取资产参考") 要打开故障单,您需要识别相应的故障单代码,并确定 要在请求正文中提交的相关资产参考。如果您已知道代码和资产引用,可以跳过此步骤。 您必须具有与故障单订购权限相对应的安装基础查看权限。 请求主体的参数将传递故障单代码`code`。 接下来,检索所需资产参考的主要和次要参考标识符。有关如何检索主要和次要ID值的说明,请参阅[如何检](https://docs.equinix.com/zh-Hans/api-catalog/assetsv1/assets/searchassets.md)索[资产](https://docs.equinix.com/zh-Hans/api-catalog/assetsv1/assets/searchassets.md)。 和`secondaryId`参数的这些值将在请求正文中传递`primaryId`。 例如,如果您面临问题子类别“遭遇总电源中断”最能代表的问题,您需要的故障单代码为`"0002-0000"`。您需要的主要资产参考是`"Cage ID"`。您还可以传递辅助资产参考,即`"Cabinet ID"`。 ## 获取联系信息[​](#获取联系信息 "直接链接至获取联系信息") 确定您要包含为本次货物技术和通知联系人的用户名。这些值可以传递给`registeredUsers`请求主体中数组中的参数`contacts`。 如果您是此订购的唯一技术和通知联系人,则可以跳过此步骤。 ## 提交一份故障单[​](#提交一份故障单 "直接链接至提交一份故障单") | `POST /v2/tickets`[View the API Reference](https://docs.equinix.com/zh-Hans/api-catalog/ticketsv2.md#tag/Tickets/operation/Create%20a%20Ticket) | | | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | | | 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 " -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 " -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`](https://docs.equinix.com/zh-Hans/api-catalog/attachmentsv1/attachments/createattachment.md)端点。 ``` curl -X POST "https://api.equinix.com/v2/tickets" -H "content-type: application/json" -H "authorization: Bearer " -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参考手册](https://docs.equinix.com/zh-Hans/api-catalog/ticketsv2/tickets/create%20a%20ticket.md)。 返回HTTP代码201并返回响应标头时,故障单创建成功。响应主体不存在。 要检索,更新,添加注释或取消此工单,请参阅API参考部分中的[工单(V2)](https://docs.equinix.com/zh-Hans/api-catalog/ticketsv2/tickets.md)以获取更多信息。