Skip to main content

POST – Systems Instance

Request​

POST https://{{ip}}/redfish/v1/Systems/Self/Actions/ComputerSystem.Reset
Content-Type: application/json
The ResetType can be one of the following values: "On", "ForceOff", "GracefulShutdown", "ForceRestart".

Request example​

{
    "ResetType": "On"
}

Response​

{
    "@odata.context": "/redfish/v1/$metadata#Task.Task(TaskState,Description,Name,Id)",
    "@odata.id": "/redfish/v1/TaskService/Tasks/1",
    "@odata.type": "#Task.v1_4_2.Task",
    "Description": "Task for Computer Reset",
    "Id": "1",
    "Name": "Computer Reset",
    "TaskState": "New"
}

  1. For success the response status is 202 with message body. For Error Responses, please refer to Error Response.

  2. After successful post call, please allow 5 seconds and verify the value of PowerState property in /redfish/v1/Systems/Self instance.

  3. Using TaskID check the TaskStatus and using MaintenanceWindowStartTime.

  4. If Task is cancelled due to invalid state action, then showing error message in corresponding tasks using TaskID check the TaskStatus.