18.3. Methods
18.3.1. Creating a New Virtual Machine Pool
A new pool requires the
name
, cluster
and template
elements. Identify the cluster
and template
with the id
attribute or name
element.
Example 18.2. Creating a virtual machine pool
POST /api/vmpools HTTP/1.1 Accept: application/xml Content-type: application/xml <vmpool> <name>VM_Pool_A</name> <cluster href="/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95"/> id="99408929-82cf-4dc7-a532-9d998063fa95" <template href="/api/templates/00000000-0000-0000-0000-000000000000"/> id="00000000-0000-0000-0000-000000000000" </vmpool>
18.3.2. Updating a Virtual Machine Pool
The
name
, description
, size
, prestarted_vms
and max_user_vms
can be updated after the virtual machine has been created.
Example 18.3. Updating a virtual machine pool
PUT /api/vmpools/2d2d5e26-1b6e-11e1-8cda-001320f76e8e HTTP/1.1 Accept: application/xml Content-type: application/xml <vmpool> <name>VM_Pool_B</name> <description>Virtual Machine Pool B</description> <size>3</size> <prestarted_vms>1</size> <max_user_vms>2</size> </vmpool>
18.3.3. Removing a Virtual Machine Pool
Removal of a virtual machine pool requires a
DELETE
request.
Example 18.4. Removing a virtual machine
DELETE /api/vmpools/2d2d5e26-1b6e-11e1-8cda-001320f76e8e HTTP/1.1 HTTP/1.1 204 No Content