Introdução a chamados

O sistema de chamado da SoftLayer é o principal meio de comunicação para clientes interagirem com os grupos de suporte da SoftLayer. O serviço SoftLayer_Ticket fornece um ponto de interação para chamados individuais e todos os chamados de uma conta podem ser a interface feita por meio de SoftLayer_Account.

Listando

Uma lista de todos os chamados pode ser reunida a partir do serviço SoftLayer_Account com SoftLayer_Account::getTickets. Esse método retorna uma matriz de objetos de tipos de dados SoftLayer_Ticket.

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

Além disso, é possível recuperar somente chamados abertos ou fechados com SoftLayer_Account::getOpenTickets e SoftLayer_Account::getClosedTickets.

Detalhes

Para obter informações sobre um chamado específico, como o ID, a última data de modificação ou o status, podemos usar SoftLayer_Ticket::getObject que retorna um objeto SoftLayer_Ticket. As máscaras de objeto podem ser usadas para incluir propriedades relacionais da SoftLayer_Ticket. Abaixo está um exemplo de como usar getObject no serviço SoftLayer_Ticket com uma máscara de objeto que fornece o nome do usuário designado e todas as atualizações do chamado.

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

Criando

Listando assuntos

Ao criar um chamado, um ID de assunto válido é necessário. Uma lista de todos os assuntos possíveis é reunida com 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'

Envio de chamado

A criação de um novo chamado é realizada com o método SoftLayer_Ticket::createStandardTicket. Primeiro, um objeto de modelo SoftLayer_Ticket é criado contendo os detalhes do chamado. Cada objeto de modelo de chamado precisará pelo menos das propriedades a seguir definidas:
• subjectId: o ID do assunto a ser usado como título do chamado
• assignedUserId: um usuário designado para o chamado, que geralmente é configurado para o criador do chamado.
SoftLayer_Ticket::createStandardTicket pode ser chamado com o objeto de modelo e o conteúdo para a primeira mensagem do chamado.

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

Atualizando

Uma atualização de um chamado pode ser feita com SoftLayer_Ticket::addUpdate. Um objeto de modelo deve ser fornecido:

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