创建故障单

仅当服务中断或丢失时需要立即响应的请求才应提交故障单。对于所有其他请求，请提交 Smart Hands 请求。如果丢失或中断是由 Equinix 造成的，则将被视为“Equinix 造成的”，不会产生任何费用。但是，如果问题不是由 Equinix 造成的，则将收取正常的 Smart Hands 费用。

为了帮助您决定提交哪个请求，请参阅决定是创建 Smart Hands 还是 Trouble Ticket。

识别问题并获取资产参考

要创建故障单，您需要确定相应的故障单代码并确定…… 请在请求正文中提交相关的资产引用信息。如果您已经知道代码和资产引用信息，则可以跳过此步骤。

您必须具有与故障单订购权限相对应的安装基础查看权限。

故障单代码将作为请求正文中的 code 参数传递。

接下来，请检索所需资产引用的主标识符和辅助标识符。有关如何检索主标识符和辅助标识符值的说明，请参阅如何检索资产。

这些值将作为请求正文中的 primaryId 和 secondaryId 参数传递。

例如，如果您遇到的问题属于“完全断电”子类别，则所需的故障单代码为“0002-0000”。您需要的主要资产参考信息是“机柜 ID”。您还可以提供辅助资产参考信息，即“机柜 ID”。

获取联系信息

请确定您希望包含在本次发货的技术联系人和通知联系人中的用户名。这些值可以传递给请求正文中 contacts 数组的 registeredUsers 参数。

如果您是此订购的唯一技术和通知联系人，则可以跳过此步骤。

提交一份故障单

API specification for "ticketsv2" not found.

此方法会为已认证用户创建故障单请求。具备故障单订购权限。

提供尽可能多的信息以加快解决问题。

cURL 请求示例：

一张工单至少需要提供以下参数：代码、描述、主ID、发生日期时间。技术和通知联系人默认使用订购联系人（已验证用户），除非另有指定。

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 请求示例：

此方案与前一个方案类似，区别在于增加了一位指定的Customer Portal用户技术联系人。订购联系人仍然是默认的通知联系人。

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 参考。%20a%20张票）。

返回 HTTP 代码 201 且返回响应头时，表示故障单创建成功。没有响应主体。

识别问题并获取资产参考​

获取联系信息​

提交一份故障单​

识别问题并获取资产参考

获取联系信息

提交一份故障单