voxel.voxservers.reimage

Reimage a VoxSERVER device already assigned to the customer's account.

Parameters

hostname (required)
Hostname for the new device. This must contain only letters, numbers, dashes, and dots, and must begin/end with a letter or number. The use of a fully qualified domain name is recommended.
device_id (required)
Numeric Voxel device id, available from devices.list
image_id (required)
Operating system image identifier; use images.list to get the list of available images.
image_version_id (optional)
Operating system image version identifier. Uniquely identifies a deployment.
postinstall_script (optional)
Postinstall script to be run after a VoxSTRUCTURE device is successfully provisioned. Must contain the complete contents of the script to be run.
swap_space (optional)
Swap space (in GB) to allocate to the VoxSTRUCTURE device (from within the total disk allocation). 1 GB per processor core by default. Must be nonzero integer.

Authentication Settings

admin_password (optional)
Password for administrative user (root) access. Generated if unset, available in devices.list.
console_password (optional)
Password for remote console. Generated if unset, available in devices.list.
ssh_username (optional)
Username for SSH access.
ssh_password (optional)
Password for SSH access. Generated if unset, available in devices.list.
voxel_access (optional)
Allow Voxel administrative access to the machine. Should be either "true" or "false". Defaults to "false"

Network Settings

backend_ip (optional)
Backend IP address to assign to the VoxSTRUCTURE device --- must be chosen from the customer's private VLAN assignment.
frontend_ip (optional)
Public-facing IP address to assign to the VoxSTRUCTURE device --- must be chosen from the customer's public VLAN assignment.

Example Response

<rsp stat="ok">
  <device>
     <id>1234</id>
     <last_update>1235386846</last_update>
     <status>IN_PROGRESS</status>
  </device>
</rsp>

Notes

This method will initiate reimaging of a VoxSERVER already assigned to a customer's account. If an IP assignment already exists and no new IP assignment related details are provided, the same assignment is kept; if new details are provided, the old assignment is discarded. On failure, the server remains assigned to the account but its state is undefined; in this case, you may attempt reimaging again, or contact support@voxel.net for assistance.

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.
206: Failed acquiring resource
A resource required to perform the action could not be obtained.