Check the status of a VoxCLOUD VM.


device_id (optional)
Numeric Voxel device id, available from voxel.devices.list
verbosity (optional)
Verbosity of response. Should be one of "compact", "normal", or "extended".

Example Response

<rsp stat="ok">


This method will query the VoxCLOUD infrastructure for your VM's status. Possible values include: QUEUED (VM is awaiting allocation); IN_PROGRESS (VM is in the process of being allocated); SUCCEEDED (VM is online); OFF (VM is turned off, only billing for disk usage); DELETED (VM has been deleted); FAILED (VM allocation failed; contact Voxel support for help). If the verbosity parameter is set to "extended", an extended_status value with details of the current provisioning step is also returned. If no device_id is given, the status for all of your VoxCLOUD VMs will be returned.

Method Specific Error Codes

100: Unknown device
The device_id passed in can't be matched to a valid device.
110: Incorrect device type
This device is of a type different than required by this method.