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 voxel.devices.list
image_id (required)
Operating system image identifier; use voxel.images.list to get the list of available images.
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. A password must be at least five characters, must contain a number, an upper case letter, and cannot be based on dictionary words. If a password is not specified, one will be generated for you automatically. Available in voxel.devices.list.
console_password (optional)
Password for remote console. A password must be at least five characters, must contain a number, an upper case letter, and cannot be based on dictionary words. If a password is not specified, one will be generated for you automatically. Available in voxel.devices.list.
ssh_username (optional)
Username for SSH access.
ssh_password (optional)
Password for SSH access. A password must be at least five characters, must contain a number, an upper case letter, and cannot be based on dictionary words. If a password is not specified, one will be generated for you automatically. Available in voxel.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 agile-support@internap.com 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. Please try again or contact Voxel for assistance.