Criar Bilhete de Problemas
Os tickets de problemas devem ser enviados somente para solicitações que exijam uma resposta imediata quando houver uma interrupção ou perda do seu serviço. Para todas as outras solicitações, envie uma solicitação Smart Hands. Se a perda ou interrupção foi causada pela Equinix, ela será considerada como "Causada pela Equinix" e não incorrerá em nenhuma cobrança. No entanto, se o problema não for causado pela Equinix, as cobranças normais do Smart Hands serão aplicadas.
Para ajudar você a decidir qual solicitação enviar, consulte Decidindo se deve criar um Smart Hands ou um ticket de problema.
Identificar problemas e obter referências de ativos
Para abrir um chamado de suporte, você precisa identificar o código de chamado apropriado e determinar o Inclua as referências de ativos relacionadas no corpo da sua solicitação. Você pode pular esta etapa se já souber o código e as referências dos 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 ticket de suporte será passado como parâmetro code no corpo da requisição.
Em seguida, recupere seus identificadores de referência primários e secundários para as referências de ativos necessárias. Consulte Como recuperar ativos para obter instruções sobre como recuperar seus valores de ID primário e secundário.
Esses valores serão passados para os parâmetros primaryId e secondaryId no corpo da sua solicitação.
Por exemplo, se você estiver enfrentando um problema que se enquadra na subcategoria "Surto de falta total de energia", o código do chamado necessário é "0002-0000". A referência primária do ativo necessária é um "ID da gaiola". Você também pode fornecer uma referência secundária do ativo, que é um "ID do gabinete".
Obtendo informações de contato
Identifique os nomes de usuário que você deseja incluir como contatos técnicos e de notificação para este envio. Esses valores podem ser passados para o parâmetro registeredUsers na matriz contacts 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
API specification for "ticketsv2" not found.
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, os seguintes parâmetros: código, descrição, ID principal e data e hora de ocorrência. Os contatos técnicos e de notificação são, por padrão, o contato que fez o pedido (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:
Este 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 de pedido 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 endpoint Arquivo de anexos.
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 dos parâmetros e descrições do corpo da requisição, consulte a Referência da API%20a%20 Bilhetes).
O ticket de problema é criado com sucesso quando o código HTTP 201 é retornado e o cabeçalho de resposta é retornado. Não há corpo de resposta.
Se você deseja recuperar, atualizar, adicionar notas ou cancelar este ticket, consulte Tickets (V2) na seção de referência da API para obter mais informações.