removeAttachedVirtualGuest


SoftLayer_Ticket::removeAttachedVirtualGuest

Detach a CloudLayer Computing Instance from a ticket.

Description

Detach the given CloudLayer Computing Instance from a SoftLayer ticket. Removing an attachment may delay ticket processing time if the instance removed is relevant to the ticket’s issue. Return a boolean true upon successful detachment.

Parameters

Name Type Description
guestId int The internal identifier of the virtual guest record to detach

Required Headers

Optional Headers

  • None

Return Values

  • boolean

Error Handling

  • Throw the exception “Unable to detach null virtual guest from this ticket.” if no virtual guest identifier is provided.
  • Throw the exception “This virtual guest is not attached to this ticket.” if the given virtual guest is not attached to this ticket.
  • Throw the exception “You may not detach this virtual guest from this ticket.” if the user making the API call does not have permission to use the given virtual guest.
  • Throw the exception “Unable to detach virtual guest from this ticket.” if the API is unable to detach the given virtual guest from this ticket.

Associated Methods

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