PowerOnHost
API Request
URLs
PUT zstack/v1/hosts/power/{uuid}/actions
Headers
Authorization: OAuth the-session-uuid
Body
{
"powerOnHost": {
"returnEarly": false
},
"systemTags": [],
"userTags": []
}
In the preceding sample, both systemTags and userTags are optional. These two fields can be included in the body structure.
Curl Sample
curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X PUT -d '{"powerOnHost":{"returnEarly":false}}' //localhost:8080/zstack/v1/hosts/power/494e84c334963183bfeef342e38bf4b4/actions
Request Parameters
| Name | Type | Location | Description | Valid Values | Starting Version |
|---|---|---|---|---|---|
| uuid | String | url | The resource UUID. | 4.7.0 | |
| returnEarly | boolean | body (contained in the powerOnHost structure) | Optional. Whether to make the result returned earlier. | 4.7.0 | |
| systemTags | List | body | Optional. The system tags. | 4.7.0 | |
| userTags | List | body | Optional. The user tags. | 4.7.0 |
API Response
When the API succeeded, an empty JSON structure {} is returned. When the API failed, the returned JSON structure includes an error field. For example,
{
"error": {
"code": "SYS.1001",
"description": "A message or a operation timeout",
"details": "Create VM on KVM timeout after 300s"
}
}
SDK Sample
Java SDK
PowerOnHostAction action = new PowerOnHostAction();
action.uuid = "494e84c334963183bfeef342e38bf4b4";
action.returnEarly = false;
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
PowerOnHostAction.Result res = action.call();
Python SDK
action = PowerOnHostAction()
action.uuid = "494e84c334963183bfeef342e38bf4b4"
action.returnEarly = false
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
res = action.call()
