Skip to main content

POST /api/v1/maintenance/powerOption

Use this method to reboot or shut down the orchestrator server.

Note
This REST API requires Lenovo XClarity Orchestrator v2.1 or later.

Authentication

Authentication with username and password is required.

Resource URI

POST https://{orchestrator_server_IP}/api/v1/maintenance/powerOption

Query parameters

None

Request body

AttributesRequired / OptionalTypeDescription
powerOptionRequiredStringPower action to perform on the orchestrator server. This can be one of the following values.
  • Reboot
  • Shutdown
The following example restarts the orchestrator server.
{
"powerOption": "Reboot"
}
The following example shuts down the orchestrator server.
{
"powerOption": "Shutdown"
}

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
401UnauthorizedThe user cannot be authenticated. Authentication has not been provided or has failed. A descriptive error message is returned in the response body.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

AttributesTypeDescription
{message_attributes}variesStatus messages (see Status messages)