Créer un ticket d'incident
Les dossiers d'incident ne doivent être soumis 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 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 à choisir la demande à soumettre, reportez-vous à la rubrique création d'un Smart Hands ou d'un dossier d'incident .
Identifier le problème et obtenir des références sur les actifs
Pour ouvrir un indicateur d'incident, vous devez identifier le code de dossier d'incident approprié et déterminer les références d'actifs connexes à soumettre dans le corps de votre demande. Vous pouvez ignorer cette étape si vous connaissez déjà le code et les références de ressource.
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 requête.
Ensuite, récupérez vos identifiants de référence primaire et secondaire pour les références de ressource requises. Reportez-vous à la section récupération des ressources pour obtenir des instructions sur la récupération de vos valeurs d'ID principal et secondaire.
Ces valeurs seront transmises pour les primaryIdparamètres et secondaryIddans le corps de votre requête.
Par exemple, si vous êtes confronté à un problème 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 de ressource principale requise dont vous avez besoin est un "Cage ID". Vous pouvez également transmettre une référence de ressource 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 cette expédition. Ces valeurs peuvent être passées au registeredUsersparamètre dans le contacts tableau 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
POST /v2/ticketsView the API Reference | |
|---|---|
| Method | POST |
| URL or End Point | /v2/tickets |
| Headers | Authorization, Content-Type |
| Query Parameters | Not applicable |
| Body Parameters | code, 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 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écifique qui est un utilisateur du Portail clients. Le contact de commande est toujours 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 pièce jointe, appelez le Attachments File noeud final.
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 corporels 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.