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

    <cluster href="/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95"/>
    <template href="/api/templates/00000000-0000-0000-0000-000000000000"/>

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

    <description>Virtual Machine Pool B</description>

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