SoftLayer_Ticket::edit

Edit or update a SoftLayer ticket.

Description

Edit a SoftLayer ticket. The edit method is two-fold. You may either edit a ticket itself, add an update to a ticket, attach up to two files to a ticket, or perform all of these tasks. The SoftLayer API ignores changes made to the ‘‘userEditableFlag’’ and ‘‘accountId’’ properties. You may not assign a ticket to a user that your API account does not have access to. You may not enter a custom title for standard support tickets, buy may do so when editing an administrative ticket. Finally, you may not close a ticket using this method. Please contact SoftLayer if you need a ticket closed.

If you need to only add an update to a ticket then please use the SoftLayer_Ticket::addUpdate method in this service. Likewise if you need to only attach a file to a ticket then use the SoftLayer_Ticket::addAttachedFile method. The edit method exists as a convenience if you need to perform all these tasks at once.

Parameters

Required Headers

• Authenticate
• SoftLayer_TicketInitParameters

Optional Headers

• SoftLayer_TicketObjectMask

Return Values

• SoftLayer_Ticket

Error Handling

• Throw the exception “Please provide a subject when creating a standard support ticket.” If the $templateObject parameter does not have a subjectId set. See SoftLayer_Ticket_Subject for more information.
• Throw the exception “Please provide ticket update contents.” if no update contents are provided to the method.
• Throw the exception “You may not attach more than two files when updating a ticket.” If the ‘‘attachedFiles’’ parameter contains more than two files.

Associated Methods

• SoftLayer_Ticket::addUpdate
• SoftLayer_Ticket::addAttachedFile

REST Example

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_Ticket, string, SoftLayer_Container_Utility_File_Attachment]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Ticket/{SoftLayer_TicketID}/edit'