Crear ticket de problema
Los tickets de problemas solo deben enviarse para solicitudes que requieren una respuesta inmediata cuando hay una interrupción o pérdida de su servicio. Para todas las demás solicitudes, envíe una solicitud Smart Hands. Si la falla o interrupción fue ocasionada por Equinix, se le considerará como "Ocasionado por Equinix" y no incurrirá en ningún cargo. Sin embargo, si el problema no es causado por Equinix, se aplicarán cargos normales de Smart Hands.
Para ayudarte a decidir qué solicitud enviar, consulta Decidir si creas un Smart Hands o un ticket de problema .
Identificar el problema y obtener referencias de los activos
Para abrir un ticker de problemas, debe identificar el código de ticket de problemas adecuado y determinar las referencias de activos relacionados que debe enviar en el cuerpo de su solicitud. Puede omitir este paso si ya conoce el código y las referencias de activos.
Debe tener permisos de visualización de la Install Base que se correspondan con sus permisos de solicitud de tickets de incidencias.
El código del ticket de problema se pasará para el code parámetro El cuerpo de la solicitud.
A continuación, recupere sus identificadores de referencia primarios y secundarios para las referencias de activos requeridas. Consulte Cómo recuperar activos para obtener instrucciones sobre cómo recuperarlos valores de ID primario y secundario.
Estos valores se pasarán para los primaryIdparámetros y secondaryIden el cuerpo de su solicitud.
Por ejemplo, si se enfrenta a un problema mejor representado por la subcategoría de problema 'experimentando un corte total de energía', el código de ticket de problema que necesita es "0002-0000". La referencia de activo principal requerida que necesita es un "Cage ID". También puede pasar una referencia de activo secundario, que es un "Cabinet ID".
Obtener información de contacto
Identifique los nombres de usuario que desea incluir como contactos técnicos y de notificación para este envío. Estos valores se pueden pasar al registeredUsers parámetro en el contacts array en el cuerpo de la solicitud.
Si usted es el único contacto técnico y de notificación para esta orden, puede omitir este paso.
Envío de un aviso de problema
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} |
Este método crea una solicitud de ticket de problema para un usuario autenticado con permisos de solicitud de ticket de problema.
Facilite toda la información posible para agilizar la resolución del problema.
Ejemplo de solicitud cURL:
Un ticket requiere mínimamente que se proporcionen los siguientes parámetros: Código, descripción, primaryId, ocurredDateTime. Los contactos técnicos y de notificación predeterminados al contacto que realiza el pedido (usuario autenticado) cuando no se proporcionan específicamente.
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"
}'
Ejemplo de solicitud cURL:
Este escenario es similar al anterior, excepto para la inclusión de un contacto técnico especificado que sea usuario del Portal del Cliente. El contacto de pedido sigue siendo el contacto de notificación predeterminado.
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"
}
]
}'
Ejemplo de solicitud cURL:
Este ticket incluye un contacto técnico no registrado, contactos de notificación adicionales, referencias adicionales de activos y clientes, archivos adjuntos y detalles.
Antes de crear una orden con adjunto, llame al Attachments File punto 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
}
}'
Para obtener una lista completa de los parámetros y descripciones del cuerpo, consulte la Referencia API .
El ticket de problema se crea correctamente cuando se devuelve un código HTTP de 201 y se devuelve el encabezado de respuesta. No hay un órgano de respuesta.
Si desea recuperar, actualizar, agregar notas o cancelar este ticket, consulte Boletos (V2) en la sección de referencia de API para obtener más información.