voxel.voxcloud.clone

Clone an existing VoxCLOUD VM.

Parameters

device_id (required)
Numeric Voxel device id, available from devices.list, of the VM to clone. Device must be a VoxCLOUD VM.
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.
processing_cores (optional)
Number of processing cores to allocate to the VM. Must be a positive integer. Maximum value depends on the account type; contact Voxel if you need assistance.
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.

Authentication Settings

console_password (optional)
Password for remote console. Generated if unset, available in devices.list.

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>QUEUED</status>
  </device>
</rsp>

Notes

This method will clone an existing VoxCLOUD virtual machine. The new VM will be an exact duplicate of the existing VM at the time of cloning. Currently, the clone can only be created in the same datacenter facility as the original.

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.
401: Customer VoxSTRUCTURE quota reached
According to quotas, the customer may not allocate more devices of the desired type. Contact support@voxel.net for help adjusting quotas.
206: Failed acquiring resource
A resource required to perform the action could not be obtained.