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 /ovirt-engine/api/vmpools HTTP/1.1
Accept: application/xml
Content-type: application/xml

<vmpool>
    <name>VM_Pool_A</name>
    <cluster href="/ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95"/>
      id="99408929-82cf-4dc7-a532-9d998063fa95"
    <template href="/ovirt-engine/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 /ovirt-engine/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 /ovirt-engine/api/vmpools/2d2d5e26-1b6e-11e1-8cda-001320f76e8e HTTP/1.1

HTTP/1.1 204 No Content