Créer un ticket d'incident
Les fiches d'incident ne doivent être soumises 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, soumettez une demande de Smart Hands. Si la perte ou l'interruption a été causée par Equinix, elle sera considérée comme " causée par Equinix " et n'entraînera pas de frais. En revanche, si le problème n'est pas causé par Equinix, les frais normaux de Smart Hands s'appliqueront.
Pour vous aider à décider quelle demande soumettre, voir Décider de créer un Smart Hands ou un Trouble Ticket.
Identifier le problème et obtenir des références sur les actifs
Pour ouvrir un trouble ticker, vous devez identifier le code de trouble ticket approprié et déterminer les références d'actifs connexes à soumettre dans le corps de votre demande. Vous pouvez sauter cette étape si vous connaissez déjà le code et les références des actifs.
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 paramètre code dans le corps de la requête.
Ensuite, récupérez vos identifiants de référence primaire et secondaire pour les références d'actifs requises. Reportez-vous à How to retrieve assets pour savoir comment récupérer vos valeurs d'identifiant primaire et secondaire.
Ces valeurs seront transmises pour les paramètres primaryId et secondaryId dans le corps de votre requête.
Par exemple, si vous êtes confronté à un problème qui est mieux représenté par la sous-catégorie de problème "Expérience d'une panne de courant totale", le code de ticket d'incident dont vous avez besoin est "0002-0000". La référence primaire du bien dont vous avez besoin est un "Cage ID". Vous pouvez également transmettre une référence secondaire, qui est un ``Identifiant de l'armoire''.
Obtenir des informations de contact
Identifiez les noms d'utilisateur que vous souhaitez inclure en tant que contacts techniques et de notification pour cet envoi. Ces valeurs peuvent être passées au paramètre registeredUsers dans le tableau contacts dans le 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
API specification for "ticketsv2" not found.
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 requiert au minimum les paramètres suivants : code, description, primaryId, occurredDateTime. Les contacts techniques et de notification sont par défaut 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.
Avant de créer une commande avec une pièce jointe, appelez le Fichier de pièces jointes.
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 une liste complète des paramètres du corps et des descriptions, voir 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 de corps 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.