Passer au contenu principal

Créer un ticket d'incident

Les tickets d'incident ne doivent être envoyés que pour les demandes nécessitant une réponse immédiate en cas d'interruption ou de perte de votre service. Pour toutes les autres demandes, envoyez une demande Smart Hands. Si la perte ou l'interruption de service est due à Equinix, elle sera considérée comme « Causée par Equinix » et n'entraînera aucun frais. Toutefois, si le problème n'est pas causé par Equinix, des frais Smart Hands normaux s'appliqueront.

Pour vous aider à décider quelle demande envoyer, reportez-vous à la rubrique décider de créer un Smart Hands ou un ticket de dépannage .

Identifier le problème et obtenir des références sur les actifs​

Pour ouvrir un indicateur de panne, vous devez identifier le code de ticket de panne approprié et déterminer les références d'équipement associées à envoyer dans le corps de votre demande. Vous pouvez sauter cette étape si vous connaissez déjà le code et les références de l’équipement.

Vous devez disposer d'autorisations de visualisation de la base d'installation correspondant à vos autorisations de commande de tickets de dérangement.

Le code du ticket d'incident sera transmis pour le code paramètre du corps de la demande.

Ensuite, récupérez vos identifiants de référence principal et secondaire pour les références d’équipement requises. Pour obtenir des instructions sur larécupération de vos identifiants principal et secondaire, reportez-vous à la rubrique Comment récupérerdes actifs.

Ces valeurs seront transmises pour les primaryIdparamètres et secondaryIddans le corps de votre demande.

Par exemple, si vous êtes confronté à un problème mieux représenté par la sous-catégorie de problème « panne de courant totale », le code de ticket d'incident dont vous avez besoin est "0002-0000". La référence d'équipement principale requise est un "Cage ID". Vous pouvez également transmettre une référence d’équipement secondaire, qui est un "Cabinet ID".

Obtenir des informations de contact​

Identifiez les noms d'utilisateur que vous souhaitez inclure comme contacts techniques et de notification pour cet envoi. Ces valeurs peuvent être passées au registeredUsersparamètre du tableau dans contactsle corps de la requête.

Si vous êtes le seul contact technique et de notification pour cette commande, vous pouvez sauter cette étape.

Soumission d'un ticket d'incident​

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}

Cette méthode crée une demande de ticket de dérangement pour un utilisateur authentifié avec des permissions de commande de ticket de dérangement.

Fournissez autant d'informations que possible pour accélérer la résolution des problèmes.

Exemple de requête cURL :

Un ticket nécessite au minimum la fourniture des paramètres suivants : Code, description, primaryId, occurredDateTime. Par défaut, les contacts techniques et de notification sont le contact de commande (utilisateur authentifié) lorsqu'ils ne sont pas spécifiquement fournis.

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"  
}'

Exemple de requête cURL :

Ce scénario est similaire au précédent, à l'exception de l'inclusion d'un contact technique spécifié qui est un utilisateur du Portail client. Le contact de commande reste le contact de notification par défaut.

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"  
    }  
  ]  
}'

Exemple de requête cURL :

Ce ticket comprend un contact technique non enregistré, des contacts de notification supplémentaires, des références d'actifs et de clients supplémentaires, des pièces jointes et des détails.

note

Avant de créer une commande avec pièce jointe, appelez le 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  
  }  
}'

Pour obtenir une liste complète des paramètres corporels et des descriptions, reportez-vous à la référence API .

Le ticket d'incident est créé avec succès lorsqu'un code HTTP de 201 est renvoyé et que l'en-tête de réponse est renvoyé. Il n'y a pas d'organisme de réponse.

Si vous souhaitez récupérer, mettre à jour, ajouter des notes ou annuler ce ticket, consultez tickets (V2) dans la section référence API pour plus d’informations.

Cette page vous a-t-elle été utile ?