Mise en route avec les tickets

Le système de tickets de SoftLayer est un moyen de communication prioritaire pour les clients souhaitant interagir avec les groupes de support de SoftLayer. Le service SoftLayer_Ticket fournit un point d'interaction pour les tickets individuels. Tous les tickets d'un compte peuvent être interfacés via SoftLayer_Account.

Liste

Vous pouvez collecter la liste de tous les tickets auprès du service SoftLayer_Account avec SoftLayer_Account::getTickets. Cette méthode renvoie une matrice d'objets ayant le type de données SoftLayer_Ticket.

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

Vous pouvez aussi récupérer exclusivement les tickets ouverts ou fermés avec SoftLayer_Account::getOpenTickets et SoftLayer_Account::getClosedTickets.

Détails

Pour obtenir des informations sur un ticket, par exemple son ID, sa dernière date de modification ou son statut, utilisez SoftLayer_Ticket::getObject qui renvoie un objet SoftLayer_Ticket. Les masques d'objet permettent d'inclure les propriétés relationnelles de SoftLayer_Ticket. Vous trouvez ci-après un exemple d'utilisation de getObject dans le service SoftLayer_Ticket avec un masque d'objet fournissant le nom de l'utilisateur affecté au ticket et toutes les mises à jour du ticket.

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

Création

Liste de sujets

Lorsque vous créez un ticket, vous devez indiquer un ID de sujet valide. La liste de tous les sujets possibles est collectée avec 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'

Soumission de ticket

Pour créer un nouveau ticket, vous utilisez la méthode SoftLayer_Ticket::createStandardTicket. Dans un premier temps, un objet de modèle SoftLayer_Ticket contenant les détails du ticket est créé. Dans chaque objet de modèle du ticket, les propriétés suivantes doivent être définies :
• subjectId : l'ID du sujet à utiliser comme titre du ticket
• assignedUserId : un utilisateur affecté au ticket, en général le créateur du ticket.
SoftLayer_Ticket::createStandardTicket peut être appelé avec l'objet de modèle et le contenu du premier message du ticket.

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”)

Mise à jour

Vous pouvez mettre à jour un ticket avec SoftLayer_Ticket::addUpdate. Vous devez fournir un objet de modèle :

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