7.313. Vm 構造体
仮想マシンを表します。
名前 | タイプ | 概要 |
---|---|---|
| 自動 CPU および NUMA 設定を適用するかどうか、およびその適用方法を指定します。 | |
| 仮想マシンの BIOS 設定への参照。 | |
| このオブジェクトに関するコメントを含むフリーテキスト。 | |
| この仮想マシン用に設定されたコンソール。 | |
| 仮想マシン CPU の設定。 | |
| CPU および NUMA 設定を適用するかどうか、またどのように適用するかを指定します。 | |
| ||
| 仮想マシンの作成日。 | |
| 仮想マシンのカスタム互換性バージョン。 | |
| ||
| ||
| さまざまなフックを設定するために VDSM に送信されるプロパティー。 | |
|
| |
| プレーンテキストでの人間が判読できる説明。 | |
| 仮想マシンの表示設定。 | |
| この仮想マシン用に設定されたドメイン。 | |
| 仮想マシンの完全修飾ドメイン名。 | |
| 仮想マシンにインストールされているオペレーティングシステム。 | |
| 仮想マシンが使用するタイムゾーン (ゲストエージェントによって返されます)。 | |
|
仮想マシンに、ディスクが | |
| 仮想マシンの高可用性設定。 | |
| 一意の ID | |
| 仮想マシンの初期化設定への参照。 | |
| IO スレッドのパフォーマンスチューニング用。 | |
| 仮想マシンの大きなアイコン。 | |
| この仮想マシン/テンプレートリースが存在するストレージドメインへの参照。 | |
| 仮想マシンのメモリー (バイト単位)。 | |
| 仮想マシンのメモリー管理設定への参照。 | |
| 実行中の仮想マシンの別のホストへの移行設定への参照。 | |
| 別のホストへのライブマイグレーション中に仮想マシンが応答しないでいられる最大時間 (ミリ秒)。 | |
|
| |
| 人間が判読できるプレーンテキストでの名前。 | |
| 仮想マシンの設定が変更されたため、仮想マシンの再起動が必要です。 | |
| NUMA トポロジーの適用方法。 | |
| この仮想マシンのオリジン。 | |
| 仮想マシンにインストールされているオペレーティングシステムのタイプ。 | |
| 仮想マシンのオプションのペイロード。ISO が仮想マシンを設定するために使用されます。 | |
| 仮想マシンの配置ポリシーの設定。 | |
| この仮想マシンの乱数ジェネレーターデバイスの設定。 | |
|
| |
| クラスター内の仮想マシンのシリアル番号。 | |
| 仮想マシンの小さなアイコン。 | |
|
| |
| この仮想マシンが設定されているシングルサインオン設定への参照。 | |
|
| |
| 仮想マシンが起動された日付。 | |
|
| |
| 仮想マシンの現在の状態 | |
| 人間が読める現在のステータスの詳細。 | |
| 仮想マシンが停止した理由。 | |
| 仮想マシンが停止された日付。 | |
| ストレージエラー後に仮想マシンを再開する方法を決定します。 | |
| oVirt によって設定された仮想マシンのタイムゾーン。 | |
|
| |
|
| |
| 仮想マシンがデスクトップとサーバーのどちらに最適化されているかを決定します。 | |
| この仮想マシンの USB デバイスの設定 (カウント、タイプ)。 | |
|
| |
| VirtIO SCSI 設定への参照。 | |
| このフィールドの Virtio-SCSI contoller のキュー数には virtioScsiMultiQueuesEnabled が true である必要があります。詳細は virtioScsiMultiQueuesEnabled を参照してください。 | |
|
|
7.313.1. auto_pinning_policy
自動 CPU および NUMA 設定を適用するかどうか、およびその適用方法を指定します。
エンジンのバージョン 4.5 以降、この操作は非推奨になり、後方互換性のためにのみ保持されます。これは今後、削除される可能性があります。代わりに CpuPinningPolicy を使用してください。
7.313.2. cpu
仮想マシン CPU の設定。
ソケット設定は、仮想マシンを再起動せずに更新できます。コアとスレッドは再起動する必要があります。
たとえば、ソケットの数をすぐに 4 に変更し、再起動後にコアとスレッドの数を 2 に変更するには、以下のリクエストを送信します。
PUT /ovirt-engine/api/vms/123
リクエスト本文は以下のようになります。
<vm> <cpu> <topology> <sockets>4</sockets> <cores>2</cores> <threads>2</threads> </topology> </cpu> </vm>
7.313.3. cpu_pinning_policy
CPU および NUMA 設定を適用するかどうか、またどのように適用するかを指定します。指定されていない場合、CPU ピニング文字列の以前の動作により、CpuPinningPolicy が None または Manual に決定されます。
7.313.4. custom_compatibility_version
仮想マシンのカスタム互換性バージョン。
仮想マシンを独自の互換性バージョンにカスタマイズできるようにします。custom_compatibility_version
が設定されている場合、この特定の仮想マシンのクラスター互換性バージョンをオーバーライドします。
仮想マシンの互換バージョンは、仮想マシンが格納されているデータセンターによって制限され、仮想マシンが実行される予定のホストの機能に対してチェックされます。
7.313.5. high_availability
仮想マシンの高可用性設定。設定されている場合、仮想マシンが予期せずダウンしたときに自動的に再起動されます。
7.313.6. initialization
仮想マシンの初期化設定への参照。
Red Hat Virtualization 4.1.8 以降、このプロパティーは空のタグを送信することでクリアできます。
たとえば、initialization
属性をクリアするには、次のようなリクエストを送ります。
PUT /ovirt-engine/api/vms/123
リクエスト本文は以下のようになります。
<vm> <initialization/> </vm>
このようなリクエストへのレスポンス、およびヘッダー All-Content: true
を持つリクエストには、引き続きこの属性が含まれます。
7.313.7. large_icon
仮想マシンの大きなアイコン。ユーザーが設定するか、オペレーティングシステムに従って設定されたイメージを参照します。
7.313.8. lease
この仮想マシン/テンプレートリースが存在するストレージドメインへの参照。
リースを使用して実行している仮想マシンは、この仮想マシンの別のインスタンスが別のホストで実行されるのを防ぐために、実行中にリースが別のホストによって取得されていないことを確認する必要があります。これにより、高可用性の仮想マシンでスプリットブレインが保護されます。このテンプレートから作成された仮想マシンを、このストレージドメインをリースの場所として事前設定するために、テンプレートにリース用に定義されたストレージドメインを含めることもできます。
7.313.9. memory
仮想マシンのメモリー (バイト単位)。
たとえば、1 ギビバイト (GiB) のメモリーを含むように仮想マシンを更新するには、次の要求を送信します。
PUT /ovirt-engine/api/vms/123
リクエスト本文は、以下のようになります。
<vm> <memory>1073741824</memory> </vm>
メモリーホットプラグは、Red Hat Virtualization 3.6 以降でサポートされています。上記の例を使用して、仮想マシンが up 状態のときにメモリーを増やすことができます。サイズの増分は、HotPlugMemoryBlockSizeMb
設定値 (デフォルトでは 256 MiB) の値で割り切れる必要があります。メモリーサイズの増分がこの値で割り切れない場合、メモリーサイズの変更は次の実行設定にのみ保存されます。メモリーのホットプラグ操作が成功するたびに、1 つまたは 2 つの新しいメモリーデバイスが作成されます。
メモリーのホットアンプラグは、Red Hat Virtualization 4.2 以降でサポートされています。メモリーのホットアンプラグは、仮想マシンの状態が up の場合にのみ実行できます。ホットアンプラグ操作で取り外すことができるのは、以前にホットプラグされたメモリーデバイスのみです。要求されたメモリーの減少分は、以前にホットプラグされたメモリーデバイスの組み合わせのサイズに一致するように切り捨てられます。要求されたメモリー値は、丸められずに次の実行設定に格納されます。
この例のメモリーは、次の式を使用してバイトに変換されます:
1 GiB = 230 バイト = 1073741824 バイト。
Red Hat Virtualization Manager は内部的に値を切り捨てて整数の MiB (1MiB = 220 バイト) にします。
7.313.10. migration
実行中の仮想マシンの別のホストへの移行設定への参照。
このメソッドが返す ID で移行ポリシーを照会する API はまだ実装されていません。/ovirt-engine/api/options/MigrationPolicies
を使用して、すべての移行ポリシーとその ID のリストを取得します。
7.313.11. migration_downtime
別のホストへのライブマイグレーション中に仮想マシンが応答しないでいられる最大時間 (ミリ秒)。
仮想マシンに対して明示的に設定するか、engine-config -s DefaultMaximumMigrationDowntime=[value]
で設定します。
7.313.12. next_run_configuration_exists
仮想マシンの設定が変更されたため、仮想マシンの再起動が必要です。変更された設定は、仮想マシンの シャットダウン 処理時に適用されます。
7.313.13. numa_tune_mode
NUMA トポロジーの適用方法。非推奨となりました。vNUMA ノードごとの NUMA 調整が使用されます。
7.313.14. origin
この仮想マシンのオリジン。
値:
-
ovirt
-
rhev
-
vmware
-
xen
-
external
-
hosted_engine
-
managed_hosted_engine
-
kvm
-
physical_machine
-
hyperv
7.313.15. placement_policy
仮想マシンの配置ポリシーの設定。
この設定を更新して、仮想マシンを 1 つ以上のホストにピニングできます。
複数のホストにピニングされた仮想マシンはライブマイグレーションできませんが、ホストに障害が発生した場合、高可用性になるように設定された仮想マシンは、仮想マシンがピニングされている他のホストの 1 つで自動的に再起動されます。
たとえば、仮想マシンを 2 つのホストに固定するには、以下のリクエストを送信します。
PUT /api/vms/123
リクエスト本文は以下のようになります。
<vm> <high_availability> <enabled>true</enabled> <priority>1</priority> </high_availability> <placement_policy> <hosts> <host> <name>Host1</name> </host> <host> <name>Host2</name> </host> </hosts> <affinity>pinned</affinity> </placement_policy> </vm>
7.313.16. small_icon
仮想マシンの小さなアイコン。ユーザーが設定するか、オペレーティングシステムに従って設定されたイメージを参照します。
7.313.17. sso
この仮想マシンが設定されているシングルサインオン設定への参照。コンソールを開くと、ユーザーは仮想マシンのオペレーティングシステムに自動的にサインインできます。
7.313.18. stop_reason
仮想マシンが停止した理由。オプションで、仮想マシンをシャットダウンするときにユーザーが設定します。
7.313.19. tpm_enabled
true
の場合、TPM デバイスが仮想マシンに追加されます。デフォルト値は false
です。このプロパティーは、"All-Content=true" ヘッダーが設定されている場合に、フェッチするときにのみ表示されます。
名前 | タイプ | 概要 |
---|---|---|
| オプション: | |
| 仮想マシンにインストールされているアプリケーションのリスト。 | |
| CDROM にマウントされた ISO への参照。 | |
| 仮想マシンが属するクラスターへの参照。 | |
| この仮想マシンによって使用される CPU プロファイルへの参照。 | |
| 仮想マシンにアタッチされているディスクへの参照。 | |
| 仮想マシン CPU の動的設定。 | |
| ||
| フロッピーにマウントされた ISO への参照。 | |
| この仮想マシン用に設定されたグラフィックコンソールのリスト。 | |
| 仮想マシンが実行されているホストへの参照。 | |
| この仮想マシンに関連付けられているデバイスへの参照。 | |
| 仮想マシンの設定は、インスタンスタイプの 1 つを介してオプションで事前定義できます。 | |
| 仮想マシンに割り当てられたすべての Katello エラータを一覧表示します。 | |
| 仲介デバイスの設定。 | |
| Nic[] | 仮想マシン上のネットワークインターフェイスデバイスのリストを参照します。 |
| この仮想マシンで使用される NUMA ノード設定を参照します。 | |
| 仮想マシンの作成に使用された元のテンプレートを参照します。 | |
| この仮想マシンに設定されたパーミッション。 | |
| この仮想マシンに設定されたクォータ設定への参照。 | |
| ||
| この仮想マシンに対して開かれているユーザーセッションのリスト。 | |
| 仮想マシンから取得されたすべてのスナップショットを参照します。 | |
| この仮想マシンから収集された統計データ。 | |
| 仮想マシンが属するストレージドメインへの参照。 | |
| Tag[] | |
| 仮想マシンがベースとするテンプレートへの参照。 | |
| 仮想マシンが任意のメンバーであるプールへの参照。 | |
| ウォッチドッグ設定への参照。 |
7.313.20. affinity_labels
オプション:サブクラスターのラベル付けに使用されます。
7.313.21. katello_errata
仮想マシンに割り当てられたすべての Katello エラータを一覧表示します。
GET /ovirt-engine/api/vms/123/katelloerrata
以下のような XML で応答を受け取ります。
<katello_errata> <katello_erratum href="/ovirt-engine/api/katelloerrata/456" id="456"> <name>RHBA-2013:XYZ</name> <description>The description of the erratum</description> <title>some bug fix update</title> <type>bugfix</type> <issued>2013-11-20T02:00:00.000+02:00</issued> <solution>Few guidelines regarding the solution</solution> <summary>Updated packages that fix one bug are now available for XYZ</summary> <packages> <package> <name>libipa_hbac-1.9.2-82.11.el6_4.i686</name> </package> ... </packages> </katello_erratum> ... </katello_errata>
7.313.22. original_template
仮想マシンの作成に使用された元のテンプレートを参照します。
テンプレートまたは別の仮想マシンから仮想マシンをクローンした場合、template
はブランクテンプレートにリンクし、履歴の追跡には original_template
が使用されます。
それ以外の場合は、template
と original_template
は同じです。
7.313.23. statistics
この仮想マシンから収集された統計データ。
一部の統計、特に memory.buffered
および memory.cached
は、Red Hat Virtualization ゲストエージェント が仮想マシンにインストールされている場合にのみ使用できることに注意してください。