Show Table of Contents
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
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.