ServerActionReboot
From Hostway API Documentation
(Difference between revisions)
Mike.robski (Talk | contribs) m (1 revision) |
Mike.robski (Talk | contribs) m (1 revision: Release 86) |
||
(One intermediate revision by one user not shown) | |||
Line 1: | Line 1: | ||
The reboot action allows for either a soft or hard reboot of a [[Server]]. With a soft reboot (SOFT), the operating system is signaled to restart, which allows for a graceful shutdown of all processes. A hard reboot (HARD) is the equivalent of power cycling the server. | The reboot action allows for either a soft or hard reboot of a [[Server]]. With a soft reboot (SOFT), the operating system is signaled to restart, which allows for a graceful shutdown of all processes. A hard reboot (HARD) is the equivalent of power cycling the server. | ||
− | ='''POST''' / | + | ='''POST''' /accounts/''{accountId}''/flexcloud/servers/''{id}''/action= |
== Parameters == | == Parameters == | ||
+ | ; accountId - ''string'' | ||
+ | : The selected account Id. | ||
+ | |||
; id | ; id | ||
: The unique identifier of the server to reboot. | : The unique identifier of the server to reboot. | ||
Line 29: | Line 32: | ||
: ''HTTP/1.1 405 Method Not Allowed'' : The requested action is not supported. | : ''HTTP/1.1 405 Method Not Allowed'' : The requested action is not supported. | ||
: ''HTTP/1.1 409 Conflict'' : Already rebooting. | : ''HTTP/1.1 409 Conflict'' : Already rebooting. | ||
+ | |||
+ | == Alternative URI /servers/{id}/action == | ||
+ | An alternative way to execute this call is to omit the ''accountId'' portion of the URI. In this case the system assumes the request is executed for the account identified in the [[Authentication|authorization header]]. | ||
+ | |||
+ | <code>POST /servers/{id}/action</code> | ||
[[Category:Hostway API]] | [[Category:Hostway API]] | ||
[[Category:FlexCloud Server API]] | [[Category:FlexCloud Server API]] |
Latest revision as of 11:00, 11 October 2013
The reboot action allows for either a soft or hard reboot of a Server. With a soft reboot (SOFT), the operating system is signaled to restart, which allows for a graceful shutdown of all processes. A hard reboot (HARD) is the equivalent of power cycling the server.
Contents |
[edit] POST /accounts/{accountId}/flexcloud/servers/{id}/action
[edit] Parameters
- accountId - string
- The selected account Id.
- id
- The unique identifier of the server to reboot.
[edit] JSON
{ "reboot": { "type": "HARD" } }
- type - string
- Type of reboot to perform. Values: HARD, SOFT.
[edit] Response Codes
- Success
- HTTP/1.1 202 Accepted : The request is accepted for processing.
- Failure
- HTTP/1.1 400 Bad Request : Check your parameter. / Other error
- HTTP/1.1 401 Unauthorized - This server could not verify that you are authorized to access the document you requested. Either you supplied the wrong credentials (e.g., bad password), or your browser does not understand how to supply the credentials required.
- HTTP/1.1 404 Not Found : The resource requested is not found.
- HTTP/1.1 405 Method Not Allowed : The requested action is not supported.
- HTTP/1.1 409 Conflict : Already rebooting.
[edit] Alternative URI /servers/{id}/action
An alternative way to execute this call is to omit the accountId portion of the URI. In this case the system assumes the request is executed for the account identified in the authorization header.
POST /servers/{id}/action