6.278. VmPool


仮想マシンプールを管理するためのサービス。

表6.872 メソッドの概要
名前Summary

allocatevm

この操作により、仮想マシンが仮想マシンプールに割り当てられます。

get

仮想マシンプールを取得します。

remove

仮想マシンプールを削除します。

update

仮想マシンプールを更新します。

6.278.1. allocatevm POST

この操作により、仮想マシンが仮想マシンプールに割り当てられます。

POST /ovirt-engine/api/vmpools/123/allocatevm

仮想マシンの割り当てアクションはアクション固有のパラメーターを実行しないため、リクエストの本文には空の action が含まれている必要があります。

<action/>
表6.873 パラメーターの概要
名前方向Summary

async

ブール値

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>
表6.874 パラメーターの概要
名前方向Summary

filter

ブール値

In

ユーザーのパーミッションにしたがって、結果をフィルターする必要があるかどうかを示します。

follow

String

In

たどる 必要のある内部リンクを指定します。

pool

VmPool

Out

取得した仮想マシンプール。

6.278.2.1. follow

たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。

6.278.3. remove DELETE

仮想マシンプールを削除します。

DELETE /ovirt-engine/api/vmpools/123
表6.875 パラメーターの概要
名前方向Summary

async

ブール値

In

削除を非同期的に実行するかどうかを指定します。

6.278.4. update PUT

仮想マシンプールを更新します。

PUT /ovirt-engine/api/vmpools/123

namedescriptionsizeprestarted_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>
表6.876 パラメーターの概要
名前方向Summary

async

ブール値

In

更新を非同期的に実行するかどうかを指定します。

pool

VmPool

In/Out

更新中の仮想マシンプール。

seal

ブール値

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>
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.