voxel.voxservers.create

Find VoxSERVER inventory matching a requested configuration and provision it.

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.
configuration_id (required)
Hardware configuration identifier; unique to a particular VoxSERVER hardware configuration.
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.
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 search the VoxSERVER inventory at the requested facility for a device matching the desired configuration; if one is found, it will be assigned to the customer, its details will be filled out appropriately, and a reimaging of the machine will be initiated.

Method Specific Error Codes

402: Requested server configuration unavailable
The server configuration you requested is not currently available for provisioning at this facility
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.