Cómo empezar con los tíquets

El sistema de tíquets de SoftLayer es un medio de comunicación primario para que los clientes puedan interactuar con los grupos de soporte de SoftLayer. El servicio SoftLayer_Ticket proporciona un punto de interacción para tíquets individuales, y se puede interactuar con todos los tíquets de una cuenta mediante SoftLayer_Account.

Listado

Puede generarse una lista de todos los tíquets en el servicio SoftLayer_Account con SoftLayer_Account::getTickets. Este método devuelve una matriz de objetos de tipo de datos SoftLayer_Ticket.

import SoftLayer
client = SoftLayer.Client()
tickets = client['Account'].getTickets()

Asimismo, puede recuperar sólo tíquets abiertos o cerrados con SoftLayer_Account::getOpenTickets y SoftLayer_Account::getClosedTickets, respectivamente.

Detalles

Para obtener información sobre un tíquet específico como, por ejemplo, el ID, la fecha de última modificación o el estado, podemos utilizar SoftLayer_Ticket::getObject, que devuelve un objeto SoftLayer_Ticket. Las máscaras de objeto pueden utilizarse para incluir propiedades relacionales de SoftLayer_Ticket. A continuación, se muestra un ejemplo de utilizar getObject en el servicio SoftLayer_Ticket con una máscara de objeto que proporciona el nombre del usuario asignado y todas las actualizaciones de tíquets.

mask = ('mask[id, title, assignedUser[firstName, lastName],'
                'createDate,lastEditDate,updates[entry],updateCount]')
return client[‘Ticket’].getObject(id=ticket_id, mask=mask)

Creación

Listado de asuntos

Cuando se crea un tíquet, se necesita un ID válido de asunto. Para recopilar una lista de todos los asuntos posibles, utilice SoftLayer_Ticket_Subject::getAllObjects:

subjects = client['Ticket_Subject'].getAllObjects()
ID SUBJECT
1001 'Accounting Request'
1002 'Sales Request'
1003 'Reboots and Console Access'
1041 'DNS Request'
1021 'Hardware Issue'
1022 'Public Network Question'
1061 'Private Network Question'
1201 'DOS/Abuse Issue'
1101 'Security Issue'
1121 'Hardware Firewall Question'
1122 'Hardware Load Balancer Question'
1004 'OS Reload Question'
1005 'Portal Information Question'
1081 'Licensing Question'
1141 'Mail Server Issue'
1161 'StorageLayer Question'
1181 'CDNLayer Question'
1221 'Transcoding Question'
1261 'Colocation Service Request'

Envío de tíquets

Para crear un nuevo tíquet, se utiliza el método SoftLayer_Ticket::createStandardTicket. En primer lugar, se crea un objeto de plantilla SoftLayer_Ticket que contiene los detalles del tíquet. Como mínimo, cada objeto de plantilla de tíquet deberá tener definidas las siguientes propiedades:
• subjectId: el ID del asunto que se va a utilizar como título para el tíquet.
• assignedUserId: un usuario asignado para el tíquet, que normalmente se establece en el creador del tíquet.
SoftLayer_Ticket::createStandardTicket puede invocarse con el objeto de plantilla y el contenido del primer mensaje de tíquet.

import SoftLayer
client = SoftLayer.Client()
currentUser = client[‘Account’].getCurrentUser()
new_ticket = {
       'subjectId': ID,
       'assignedUserId': currentUser['id']
}
created_ticket = client[‘Ticket’].createStandardTicket(new_ticket, “This is the content of the ticket xxxx”)

Actualización

Puede realizarse una actualización del tíquet con SoftLayer_Ticket::addUpdate. Debe proporcionarse un objeto de plantilla:

ticket_update = {
                 'entry': "This is a test update, please ignore",
                 }
tickets = client['Ticket'].addUpdate(ticket_update, id=8988302)