Crear Ticket de problema
Los tickets de problemas sólo deben enviarse para solicitudes que requieran una respuesta inmediata cuando se produzca una interrupción o pérdida de su servicio. Para todas las demás solicitudes, envíe una solicitud de Smart Hands. Si la pérdida o interrupción fue causada por Equinix, se considerará como "Causada por Equinix" y no incurrirá en ningún cargo. Sin embargo, si el problema no ha sido causado por Equinix, se aplicarán los cargos normales de Smart Hands.
Para ayudarle a decidir qué solicitud enviar, consulte Decidir si crear un Smart Hands o un Ticket de problema.
Identificar el problema y obtener referencias de los activos
Para abrir una ficha de problema, debe identificar el código de ficha de problema adecuado y determinar las referencias de activos relacionadas 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á por el parámetro code al cuerpo de la solicitud.
A continuación, recupere sus identificadores de referencia primarios y secundarios para las referencias de activos necesarias. Consulte Cómo recuperar activos para obtener instrucciones sobre cómo recuperar sus valores de identificador primario y secundario.
Estos valores se pasarán para los parámetros primaryId y secondaryId en el cuerpo de su solicitud.
Por ejemplo, si se enfrenta a un problema representado mejor 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 que necesita es un "ID de jaula". También puede pasar una referencia de activo secundaria, que es un "ID de armario".
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 pueden pasarse al parámetro registeredUsers de la matriz contacts del 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
API specification for "ticketsv2" not found.
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 como mínimo que se proporcionen los siguientes parámetros: código, descripción, primaryId, occurredDateTime. Los contactos técnicos y de notificación se asignan por defecto al contacto del 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 por la inclusión de un contacto técnico especificado que es usuario del Portal del Cliente. El contacto de pedidos sigue siendo el contacto de notificación por defecto.
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 un pedido con archivo adjunto, llame al punto final 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
}
}'
Para obtener una lista completa de los parámetros del cuerpo y sus descripciones, consulte la Referencia API.
El ticket de problema se crea con éxito cuando se devuelve un código HTTP de 201 y se devuelve la cabecera de respuesta. No hay cuerpo de respuesta.
Si desea recuperar, actualizar, añadir notas o cancelar este ticket, consulte Tickets (V2) en la Sección de referencia de la API para obtener más información.