6.278. VmPool
仮想マシンプールを管理するためのサービス。
名前 | Summary |
---|---|
| この操作により、仮想マシンが仮想マシンプールに割り当てられます。 |
| 仮想マシンプールを取得します。 |
| 仮想マシンプールを削除します。 |
| 仮想マシンプールを更新します。 |
6.278.1. allocatevm POST
この操作により、仮想マシンが仮想マシンプールに割り当てられます。
POST /ovirt-engine/api/vmpools/123/allocatevm
仮想マシンの割り当てアクションはアクション固有のパラメーターを実行しないため、リクエストの本文には空の action
が含まれている必要があります。
<action/>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | 割り当てを非同期で実行する必要があるかどうかを示します。 |
6.278.2. get GET
仮想マシンプールを取得します。
GET /ovirt-engine/api/vmpools/123
次のような XML 応答が返されます。
<vm_pool id="123"> <actions>...</actions> <name>MyVmPool</name> <description>MyVmPool description</description> <link href="/ovirt-engine/api/vmpools/123/permissions" rel="permissions"/> <max_user_vms>1</max_user_vms> <prestarted_vms>0</prestarted_vms> <size>100</size> <stateful>false</stateful> <type>automatic</type> <use_latest_template_version>false</use_latest_template_version> <cluster id="123"/> <template id="123"/> <vm id="123">...</vm> ... </vm_pool>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | ユーザーのパーミッションにしたがって、結果をフィルターする必要があるかどうかを示します。 | |
| In | たどる 必要のある内部リンクを指定します。 | |
| Out | 取得した仮想マシンプール。 |
6.278.2.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.278.3. remove DELETE
仮想マシンプールを削除します。
DELETE /ovirt-engine/api/vmpools/123
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | 削除を非同期的に実行するかどうかを指定します。 |
6.278.4. update PUT
仮想マシンプールを更新します。
PUT /ovirt-engine/api/vmpools/123
name
、description
、size
、prestarted_vms
、および max_user_vms
属性は、仮想マシンプールの作成後に更新できます。
<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>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | 更新を非同期的に実行するかどうかを指定します。 | |
| In/Out | 更新中の仮想マシンプール。 | |
| In | プール用に作成された仮想マシンを作成後にシールする必要があるかどうかを指定します。 |
6.278.4.1. seal
プール用に作成された仮想マシンを作成後にシールする必要があるかどうかを指定します。
このオプションのパラメーターが指定され、その値が true
の場合、プール用に作成された仮想マシンは作成後にシールされます。値が 'false' の場合、仮想マシンはシールされません。パラメーターが提供されていない場合、仮想マシンは、シールされたテンプレートから作成され、そしてゲスト OS が Windows に設定されていない場合にのみ、シールされます。このパラメーターは、プールが更新されたときに作成された仮想マシンにのみ影響します。
たとえば、仮想マシンプールを更新し、作成された追加の仮想マシンをシールするには、次のようなリクエストを送信します。
PUT /ovirt-engine/api/vmpools/123?seal=true
以下のボディーを使用します。
<vmpool> <name>VM_Pool_B</name> <description>Virtual Machine Pool B</description> <size>7</size> </vmpool>