removeAttachedHardware


SoftLayer_Ticket::removeAttachedHardware

detach hardware from a ticket.

Description

detach the given hardware from a SoftLayer ticket. Removing a hardware attachment may delay ticket processing time if the hardware removed is relevant to the ticket’s issue. Return a boolean true upon successful hardware detachment.

Parameters

Name Type Description
hardwareId int The internal identifier of the hardware record to detach

Required Headers

Optional Headers

  • None

Return Values

  • boolean

Error Handling

  • Throw the exception “Unable to detach null hardware from this ticket.” if no hardware identifier is provided.
  • Throw the exception “This hardware is not attached to this ticket.” if the given hardware is not attached to this ticket.
  • Throw the exception “You may not detach this hardware from this ticket.” if the user making the API call does not have permission to use the given hardware.
  • Throw the exception “Unable to detach hardware from this ticket.” if the API is unable to detach the given hardware 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}/removeAttachedHardware'