185e6e9302
This API is redundant because all the status can be displayed in server response. Change-Id: I5013d6746d2f6c4380563f319b3bd1fba7671bd6 Closes-Bug: #1717406
113 lines
2.1 KiB
ReStructuredText
113 lines
2.1 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
=================
|
|
Server States
|
|
=================
|
|
|
|
Servers States can be managed through states sub-resource.
|
|
|
|
A Server can be rebooted, turned on, or turned off by requesting a change to
|
|
its power state.
|
|
|
|
|
|
Change Server Power State
|
|
===========================
|
|
|
|
.. rest_method:: PUT /v1/servers/{server_uuid}/states/power
|
|
|
|
Request a change to the Server's power state.
|
|
|
|
Normal response code: 202
|
|
|
|
Error codes:
|
|
- 409 (ClientError)
|
|
- 400 (InvalidState)
|
|
- 406 (NotAcceptable)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- server_uuid: server_ident
|
|
- target: power_state_target
|
|
|
|
**Example request to power off a Server:**
|
|
|
|
.. literalinclude:: samples/server_states/server-set-power-off.json
|
|
|
|
Response
|
|
--------
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
Change Server Lock State
|
|
===========================
|
|
|
|
.. rest_method:: PUT /v1/servers/{server_uuid}/states/lock
|
|
|
|
Request a change to the Server's lockstate.
|
|
|
|
Normal response code: 202
|
|
|
|
Error codes:
|
|
- 409 (ClientError)
|
|
- 400 (BadRequest)
|
|
- 403 (Forbidden)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- server_uuid: server_ident
|
|
- target: lock_state
|
|
|
|
**Example request to lock a Server:**
|
|
|
|
.. literalinclude:: samples/server_states/lock-server.json
|
|
|
|
**Example request to unlock a Server:**
|
|
|
|
.. literalinclude:: samples/server_states/unlock-server.json
|
|
|
|
Response
|
|
--------
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
Change Server Provision State
|
|
===============================
|
|
|
|
.. rest_method:: PUT /v1/servers/{server_uuid}/states/provision
|
|
|
|
Request a change to the Server's provision state.
|
|
|
|
Normal response code: 202
|
|
|
|
Error codes:
|
|
- 409 (ClientError)
|
|
- 400 (BadRequest)
|
|
- 403 (Forbidden)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- server_uuid: server_ident
|
|
- target: provision_state
|
|
- image_uuid: image_ident
|
|
- preserve_ephemeral: preserve_ephemeral
|
|
|
|
**Example request to rebuild a Server:**
|
|
|
|
.. literalinclude:: samples/server_states/rebuild-server.json
|
|
|
|
Response
|
|
--------
|
|
|
|
If successful, this method does not return content in the response body.
|