Ir para o conteúdo principal

Crie um chamado de problema

Os trouble tickets só devem ser enviados para solicitações que exijam uma resposta imediata quando houver uma interrupção ou perda do 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 ajudar você 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 trouble ticker, você precisa identificar o código do trouble ticket apropriado e determinar as referências de ativos relacionados a enviar no corpo da 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 trouble ticket 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 primário e secundário.

Esses valores serão passados para os primaryIdparâmetros e secondaryIdno corpo da 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 ticket de problema de que você precisa é "0002-0000". A referência de ativo primário necessária de que você precisa é 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 você 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
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}

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: Código, descrição, primaryId, ockerredDateTime. Os contatos técnicos e de notificação são padronizados para o contato do 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 do 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.

observação

Antes de criar um pedido com anexo, ligue para o Attachments File terminal.

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, consulte a Referência do API .

O chamado 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.

Para recuperar, atualizar, adicionar notas ou cancelar este ticket, consulte Tickets (V2) na seção Referência do API para obter mais informações.

Esta página foi útil?