ServerActionReboot

(Difference between revisions)
Jump to: navigation, search
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''' /servers/'''id'''/action==
+
='''POST''' /servers/'''id'''/action=
  
=== Parameters ===
+
== Parameters ==
 
; id
 
; id
 
: The unique identifier of the server to reboot.
 
: The unique identifier of the server to reboot.
  
==== JSON ====
+
=== JSON ===
 
  <nowiki>
 
  <nowiki>
 
{
 
{
Line 19: Line 19:
 
: Type of reboot to perform. Values: '''HARD''', '''SOFT'''.
 
: Type of reboot to perform. Values: '''HARD''', '''SOFT'''.
  
=== Response Codes ===
+
== Response Codes ==
 
; Success:  
 
; Success:  
 
: ''HTTP/1.1 202 Accepted'' : The request is accepted for processing.
 
: ''HTTP/1.1 202 Accepted'' : The request is accepted for processing.
Line 32: Line 32:
 
[[Category:Hostway API]]
 
[[Category:Hostway API]]
 
[[Category:FlexCloud Server API]]
 
[[Category:FlexCloud Server API]]
 
<!--  THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->
 
 
{{#widget:DISQUS
 
|id=hostway
 
|uniqid={{PAGENAME}}
 
|url={{fullurl:{{PAGENAME}}}}
 
}}
 
 
<!--  ########################################################################### -->
 

Revision as of 08:11, 20 May 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

POST /servers/id/action

Parameters

id
The unique identifier of the server to reboot.

JSON

{
   "reboot":
      {
         "type": "HARD"
      }
}
type - string
Type of reboot to perform. Values: HARD, SOFT.

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.
Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox