SoftLayer Hardware Server::getObject

From SoftLayer Development Network Wiki

Jump to: navigation, search

getObject is a member of the SoftLayer_Hardware_Server service.

Contents

Overview

getObject retrieves the SoftLayer_Hardware_Server object whose ID number corresponds to the ID number of the init parameter passed to the SoftLayer_Hardware service. You can only retrieve servers from the account that your portal user is assigned to.

User Access

Users wishing to execute getObject must have the following permissions assigned to their account:

  • View Hardware Details

Return Type

getObject returns the SoftLayer_Hardware_Server data type.

Headers

Required Headers

getObject requires the following headers set:

Optional Headers

getObject takes the following optional headers:

Error Handling

getObject throws the following exceptions:

  • SoftLayer_Exception_ObjectNotFound
Throw the error "Unable to find object with id of {id}." if the given initialization parameter has an invalid id field.
  • SoftLayer_Exception_AccessDenied
Throw the error "Access Denied." if the given initialization parameter id field is not the account id of the user making the API call.
  • SoftLayer_Exception
Throw the error "Method has not been implemented for this object type." id the method is used.
Personal tools