reloadCurrentOperatingSystemConfiguration


SoftLayer_Hardware_Server::reloadCurrentOperatingSystemConfiguration

Reloads current operating system configuration.

Description

Reloads current operating system configuration.

This service has a confirmation protocol for proceeding with the reload. To proceed with the reload without confirmation, simply pass in ‘FORCE’ as the token parameter. To proceed with the reload with confirmation, simply call the service with no parameter. A token string will be returned by this service. The token will remain active for 10 minutes. Use this token as the parameter to confirm that a reload is to be performed for the server.

As a precaution, we strongly recommend backing up all data before reloading the operating system. The reload will format the primary disk and will reconfigure the server to the current specifications on record.

The reload will take AT MINIMUM 66 minutes.


Parameters

Name Type Description
token string The token returned by this service as a confirmation to proceed with the reload.

Required Headers

Optional Headers

  • None

Return Values

  • string

Error Handling

  • Throws the exception ‘You do not have permission to this service.’ when a user does not have permission to Issue OS Reloads.
  • Throws the exception ‘There is currently an outstanding transaction for this server.’ when there is a current hardware update.
  • Throws the exception ‘This server currently does not have an operating system.’ when the server does not have an operating system in its current configuration.
  • Throws the exception ‘Invalid token provided.’ when an invalid token is provided.
curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [string]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Hardware_Server/{SoftLayer_Hardware_ServerID}/reloadCurrentOperatingSystemConfiguration'