1. Operations
2. vcenter
3. vm
4. power

## vcenter vm power: get

Returns the power state information of a virtual machine.

### Request:

#### HTTP request

GET https://{server}/rest/vcenter/vm/{vm}/power

#### Path Parameters

Name | Type | Description
--- | --- | ---
Required
vm | string | Virtual machine identifier.

### Response:

#### HTTP Status Code: 200

#### Representations:

- JSON
- XML

{
"value": {
"clean_power_off": true,
"state": "POWERED_OFF"
}
}
<?xml version="1.0" ?>
<ns0:Get-Result xmlns:ns0="http://vmware.com/vcenter/vm/power" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>
<clean_power_off>true</clean_power_off>
<state>POWERED_OFF</state>
</value>
</ns0:Get-Result>

#### Response Type:

Name | Type | Description
--- | --- | ---
bold = required
value | info | Power state information for the specified virtual machine.
value.state | string | Power state of the virtual machine. Defines the valid power states for a virtual machine. Value is one of: POWERED_OFF: The virtual machine is powered off. POWERED_ON: The virtual machine is powered on. SUSPENDED: The virtual machine is suspended.
value.clean_power_off | boolean | Flag indicating whether the virtual machine was powered off cleanly. This field may be used to detect that the virtual machine crashed unexpectedly and should be restarted. Optional. It is only relevant when state has value POWERED_OFF. This field is optional and it is only relevant when the value of `state` is POWERED_OFF.

#### Errors:

HTTP Status Code | Type | Description
--- | --- | ---
500 | error | if the system reports an error while responding to the request.
404 | not_found | if the virtual machine is not found.
400 | resource_inaccessible | if the virtual machine's configuration or execution state cannot be accessed.
503 | service_unavailable | if the system is unable to communicate with a service to complete the request.
401 | unauthenticated | if the user can not be authenticated.
403 | unauthorized | if the user doesn't have the required privileges.