|
|
(3 intermediate revisions by one user not shown) |
Line 1: |
Line 1: |
− | The [[Server|server]] create VM command
| |
− | ==Path==
| |
− | */server/editvm/$vmid
| |
| | | |
− | ==Method==
| |
− | *[[glossary#POST|POST]]
| |
− |
| |
− | ==Availability==
| |
− | *[[servers#Dynamic Server|Dynamic Server]]
| |
− |
| |
− | ==Optional Data Parameters==
| |
− | *{$hostname}: The hostname of the [[glossary#Virtual Machine|virtual machine]], it must be unique and not currently in use on any other server or [[glossary#Virtual Machine|virtual machine]] in [[glossary#LEAP|LEAP]].
| |
− | *{$memory}: The amount of RAM assigned to the [[glossary#Virtual Machine|virtual machine]] in kilobytes, it must be greater than 512 MB (524,288 KB).
| |
− | *{$storage}: The amount of storage space assigned to the [[glossary#Virtual Machine|virtual machine]] in kilobytes, must be greater than 10GB (10,485,760 KB).
| |
− | *{$cpu_allocation}: How vcpus/priority should be applied to a new virtual machine.
| |
− | *** dedicated
| |
− | blah
| |
− | **{$priority}: The CPU priority for the [[glossary#Virtual Machine|virtual machine]] (1 – 100)%.
| |
− | *** If $cpu_allocation is 'dedicated', priority isn't used. If $cpu_allocation is 'limited', a VM will have access to multiple cores and will have a set priority to those cores. if $cpu_allocation is set to 'pool', the VM has access to the whole physical CPU but are limited to the priority they're assigned.
| |
− | **{$cores}: Number of vCPUs to assign to a virtual machine.
| |
− | *** If $cpu_allocation is 'dedicated', these cores are removed from the cpu pool and actually allocated to the VM so they cannot be used by other VMs. If $cpu_allocation is set to 'limited', the VM has access to that number of cores but may share them with other VMs. Cores do not apply if $cpu_allocation is set to 'pool'
| |
− |
| |
− | ==Returned Data==
| |
− | <pre>
| |
− | stdClass Object(
| |
− | [success] => TRUE/FALSE
| |
− | [data] => stdClass Object(
| |
− | [vmid] => The server ID of the new VM.
| |
− | )
| |
− | )
| |
− | </pre>
| |