Criar tíquete de problema
Os tickets de problemas só devem ser enviados para solicitações que exijam uma resposta imediata quando houver uma interrupção ou perda de seu serviço. Para todas as outras solicitações, envie uma solicitação Smart Hands. Se a perda ou a interrupção foi causada pela Equinix, será considerado como "Causado pela Equinix" e não incorrerá em nenhuma cobrança. No entanto, se o problema não for causado pelo Equinix, serão aplicadas taxas normais de Smart Hands.
Para ajudá-lo a decidir qual solicitação enviar, consulte Decidindo se deseja criar um Smart Hands ou um Tíquete de Problemas .
Identificar problemas e obter referências de ativos
Para abrir um ticker de problemas, você precisa identificar o código do tíquete de problemas apropriado e determinar as referências de ativos relacionados a serem enviadas no corpo da sua solicitação. Você pode ignorar esta etapa se já souber o código e as referências de ativos.
Você deve ter permissões de visualização da base de instalação que correspondam às suas permissões de pedindo de tickets de problemas.
O código do tíquete de problemas será passado para o code parâmetro do corpo da solicitação.
Em seguida, recupere seus identificadores de referência primária e secundária para as referências de ativos necessárias. Consulte Como recuperar ativos para obter instruções sobre como recuperar seus valores de ID principal e secundário.
Esses valores serão passados para os primaryIdparâmetros e secondaryIdno corpo da sua solicitação.
Por exemplo, se você estiver enfrentando um problema melhor representado pela subcategoria do problema "experimentando uma queda total de energia", o código do tíquete de problema de que você precisa é "0002-0000". A referência de ativo primário necessária é um "Cage ID". Você também pode passar uma referência de ativo secundário, que é um "Cabinet ID".
Obtendo informações de contato
Identifique os nomes de usuário que deseja incluir como contatos técnicos e de notificação para esta remessa. Esses valores podem ser passados para o registeredUsers parâmetro no contactsarray no corpo da solicitação.
Se você for o único contato técnico e de notificação para este pedido, você pular esta etapa.
Envio de um Trouble Ticket
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} |
Este método cria uma solicitação de suporte para um usuário autenticado. com permissões para abrir chamados de suporte.
Forneça o máximo de informações possível para agilizar a resolução do problema.
Exemplo de solicitação cURL:
Um ticket requer, no mínimo, que os seguintes parâmetros sejam fornecidos: Code, description, primaryId, ockerredDateTime. Os contatos técnicos e de notificação são padronizados para o contato solicitante (usuário autenticado) quando não são fornecidos especificamente.
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"
}'
Exemplo de solicitação cURL:
Esse cenário é semelhante ao anterior, exceto pela inclusão de um contato técnico especificado que é um usuário do Portal do Cliente. O contato solicitante ainda é o contato de notificação padrão.
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"
}
]
}'
Exemplo de solicitação cURL:
Este ticket inclui um contato técnico não registrado, contatos adicionais para notificação, ativos adicionais e informações do cliente. Referências, anexos e detalhes.
Antes de criar um pedido com anexo, chame o Attachments File endpoint.
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
}
}'
Para obter uma lista completa de parâmetros corporais e descrições, consulte a Referência do API .
O ticket de problema é criado com sucesso quando um código HTTP de 201 é retornado e o cabeçalho de resposta é retornado. Não há corpo de resposta.
Se você quiser recuperar, atualizar, adicionar notas ou cancelar este ticket, consulte Tickets (V2) na Seção de Referência do API para obter mais informações.