voxel.voxcloud.status

Check the status of a VoxCLOUD VM.

Parameters

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">
  <devices>
    <device>
      <id>1234</id>
      <last_update>1235386846</last_update>
      <status>SUCCEEDED</status>
    </device>
  </devices>
</rsp>

Notes

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.