voxel.voxcloud.create

Provision a new VoxCLOUD VM.

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.
disk_size (required)
Total amount of disk space (in GB) to allocate to the VM (5-100), including space that will be used for a swap partition.
facility (required)
Datacenter facility code, available via voxcloud.facilities.list or voxservers.facilities.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.
processing_cores (required)
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.
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>QUEUED</status>
  </device>
</rsp>

Notes

This method will queue a new VoxCLOUD virtual machine for provisioning. The VM should be provisioned within several minutes. To check on the status of your new VM's provisioning, use voxcloud.status. Currently, RAM is assigned proportionally to processor cores: for each processor core, your VM is allocated 2 GB RAM.

Method Specific Error Codes

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.