SoftLayer_Hardware::powerCycle

Issues power cycle to server.

Description

The ‘‘‘powerCycle’’’ method completes a power off and power on of the server successively in one command. The power cycle command is equivalent to unplugging the server from the power strip and then plugging the server back in. ‘‘‘This method should only be used when all other options have been exhausted’’’. Additional remote management commands may not be executed if this command was successfully issued within the last 20 minutes to avoid server failure. Remote management commands include:

rebootSoft rebootHard powerOn powerOff powerCycle

Parameters

None

Required Headers

• Authenticate
• SoftLayer_HardwareInitParameters

Optional Headers

• None

Return Values

• boolean

Error Handling

• “Method has not been implemented for this object type.”

REST Example

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Hardware/{SoftLayer_HardwareID}/powerCycle'