Créer un ticket de dérangement
Les tickets d'incident ne doivent être soumis que pour les demandes qui nécessitent une réponse immédiate en cas d'interruption ou de perte de votre service. Pour toutes les autres demandes, soumettez une demande 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 aucun frais. Cependant, si le problème n'est pas causé par Equinix, les frais Smart Hands normaux s'appliqueront.
Pour vous aider à décider quelle demande soumettre, consultez Décider de créer un ticket Smart Hands ou un ticket d'incident.
Identifier le problème et obtenir des références d'actifs
Pour ouvrir un billet d'incident, vous devez identifier le code de billet d'incident approprié et déterminer le Veuillez inclure les références des ressources associées dans le corps de votre requête. Vous pouvez sauter cette étape si vous connaissez déjà le code et les références des ressources.
Vous devez disposer d'autorisations d'affichage de base d'installation correspondant à vos autorisations de commande de ticket d'incident.
Le code du billet d'incident sera transmis par le paramètre code dans le corps de la requête.
Ensuite, récupérez les identifiants de référence principaux et secondaires des ressources requises. Consultez la section Comment récupérer des ressources pour obtenir des instructions sur la récupération de ces identifiants.
Ces valeurs seront transmises pour les paramètres primaryId et secondaryId dans le corps de votre requête.
Par exemple, si vous rencontrez un problème correspondant à la sous-catégorie « Panne de courant totale », le code de ticket d'incident à utiliser est « 0002-0000 ». La référence principale requise pour l'équipement est un « ID de cage ». Vous pouvez également fournir une référence secondaire, à savoir un « ID d'armoire ».
Obtenir des informations de contact
Indiquez les noms d'utilisateur à inclure comme contacts techniques et de notification pour cet envoi. Ces valeurs peuvent être transmises au paramètre registeredUsers du tableau contacts dans le corps de la requête.
Si vous êtes le seul contact technique et de notification pour cette commande, vous pouvez ignorer cette étape.
Soumission d'un ticket d'incident
API specification for "ticketsv2" not found.
Cette méthode crée une demande de billet d'incident pour un utilisateur authentifié avec les autorisations de commander des billets d'incident.
Fournissez autant d’informations que possible pour accélérer la résolution du problème.
Exemple de requête cURL:
Un billet nécessite au minimum les paramètres suivants: code, description, primaryId, occurredDateTime. Les contacts techniques et de notification sont par défaut ceux du contact qui a passé la 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 billet comprend un contact technique non enregistré, des contacts de notification supplémentaires, des ressources supplémentaires et un client. Références, pièces jointes et détails.
Avant de créer une commande avec pièce jointe, appelez le point de terminaison Attachments File.
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 la liste complète des paramètres et descriptions du corps de la requête, consultez la référence de l'API.%20a%20 billets).
Un ticket d'incident est créé avec succès lorsqu'un code HTTP 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 à ce billet ou l'annuler, consultez Tickets (V2) dans la section Référence de l'API pour plus d'informations.