跳到主要内容

创建故障单

只有在服务中断或中断时需要立即响应的请求,才应提交故障单。对于所有其他请求,请提交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
MethodPOST
URL or End Point/v2/tickets
HeadersAuthorization, Content-Type
Query ParametersNot applicable
Body Parameterscode, 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)以获取更多信息。

这个页面对您有帮助吗?