Cree una solicitud de asistencia
Las solicitudes de asistencia solo 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 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 ayudarle a decidir qué solicitud enviar, consulte Decidir si desea crear una solicitud de Smart Hands o una solicitud de asistencia para problemas .

Identificar el problema y obtener referencias de los activos
Para abrir un indicador de problemas, debe identificar el código de solicitud de asistencia correspondiente 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.
Se transmitirá el código de solicitud de asistencia para el code parámetro del cuerpo de la solicitud.
A continuación, recupere sus identificadores de referencia principal y secundario para las referencias de activos requeridas. Consulte Cómo recuperar activos para obtener instrucciones sobre cómo recuperarlos valores de ID principal 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 del problema "experimentando un corte total de energía", el código de solicitud de asistencia 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 registeredUsersparámetro de la contacts matriz 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 como mínimo que se proporcionen los siguientes parámetros: Código, descripción, primaryId, ocurredDateTime. Los contactos técnicos y de notificación por defecto son el 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, salvo la inclusión de un contacto técnico especificado que sea usuario del portal del cliente. El contacto del 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 un pedido con archivo adjunto, llama 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 de API .
La solicitud de asistencia se crea correctamente cuando se devuelve un código HTTP de 201 y se devuelve el encabezado de respuesta. No hay ningún cuerpo de respuesta.
Si desea recuperar, actualizar, añadir notas o cancelar este ticket, consulte Tickets (V2) en la sección de referencia de API para obtener más información.