第15章 仮想マシン
15.1. 仮想マシン要素
vms コレクションは、Red Hat Virtualization 環境内の仮想マシンに関する情報を提供します。API ユーザーは、エントリーポイント URI から取得した rel="vms" リンクを使用してこの情報にアクセスします。
All-Content: true ヘッダーを使用して GET リクエストに関する追加情報を取得できます。
以下の表は、仮想マシンリソース表現に含まれる特定の要素を示しています。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
link rel="applications" | 関係 | 仮想マシンリソースについての アプリケーション サブコレクションへのリンク。仮想マシンにインストールされているアプリケーションが表示されます。 | |
link rel="disks" | 関係 | 仮想マシンリソースの disks サブコレクションへのリンク。 | |
link rel="nics" | 関係 | 仮想マシンリソースの nics サブコレクションへのリンク。 | |
link rel="numanodes" | 関係 | 仮想マシンリソースの numanodes サブコレクションへのリンク。 | |
link rel="cdroms" | 関係 | 仮想マシンリソースの cdroms サブコレクションへのリンク。 | |
link rel="snapshots" | 関係 | 仮想マシンリソースの snapshot サブコレクションへのリンク。 | |
link rel="tags" | 関係 | 仮想マシンリソースの タグ サブコレクションへのリンク。 | |
link rel="permissions" | 関係 | 仮想マシン パーミッションのパーミッション サブコレクションへのリンク。 | |
link rel="statistics" | 関係 | 仮想マシンリソースの 統計 サブコレクションへのリンク。 | 
|
link rel="reporteddevices" |
関係
|
仮想マシンリソースの
reporteddevices サブコレクションへのリンク。
| |
link rel="watchdogs" |
関係
|
仮想マシンリソースの
watchdogs サブコレクションへのリンク。
| |
link rel="sessions" |
関係
|
仮想マシンリソースの
sessions サブコレクションへのリンク。
| |
type | 列挙 | 仮想マシンのタイプ。列挙値のリストは、機能 で利用できます。 | 
|
status | 以下を参照してください。 | 仮想マシンのステータス。 |
|
memory | integer | ゲストに割り当てられるメモリーの量（バイト単位）。 | |
cpu | complex |
仮想マシンの CPU の詳細を定義します。
topology サブ要素は、ゲストで利用可能な論理 ソケット の数とソケットごとの コア 数を設定します。仮想マシンで利用可能なコアの合計は、ソケット数をソケットごとに乗算したソケット数と等しくなります。
cputune サブ要素は、一連の vcpupin 要素を使用して、仮想 CPU を物理ホスト CPU にマッピングします。各 vcpupin 要素には、仮想 CPU 属性(vcpu)と、使用する物理を定義する属性(cpuset)が含まれます。cpuset を、単一の CPU (2")のいずれかに設定します。
cpu_mode サブ要素は、仮想 CPU がホスト CPU にどのように関連するかを定義します。3 つの値があります。モードが指定されていない場合には custom が、libvirt が理解できるため、host_model はホスト CPU をコピーします。host_passthrough は、libvirt が認識しないものであっても、ホストのすべての側面をゲストに渡します。ただし、host_passthrough は、その仮想マシンの移行を防ぎます。
| |
os type= | 文字列( RHEL5 または WindowsXPなど) | ゲストオペレーティングシステムのタイプ。 | |
OS boot dev= | 列挙 | boot 要素の dev 属性によって記述される ブート デバイスの一覧。列挙値のリストは、機能 で利用できます。 | |
OS カーネル | string | 仮想マシンが起動するように設定されているカーネルイメージへのパス。このオプションは、BIOS ブートローダー経由ではなく、Linux カーネルを直接起動することに対応します。 | |
OS initrd | string | 以前に指定したカーネルで使用される initrd イメージへのパス。このオプションは、BIOS ブートローダー経由ではなく、Linux カーネルを直接起動することに対応します。 | |
OS cmdline | string | 定義されたカーネルで使用するカーネルコマンドラインパラメーター文字列。このオプションは、BIOS ブートローダー経由ではなく、Linux カーネルを直接起動することに対応します。 | |
high_availability | complex | 仮想マシンまたはホストがクラッシュした場合に仮想マシンを自動的に再起動する必要がある場合は、enabled を true に設定します。priority 要素は、仮想マシンの再起動順序を制御します。 | |
display | complex |
ディスプレイ
タイプ ( vnc または spiceのいずれか)、port、および モニター の数。allow_reconnect ブール値は、クライアントがディスプレイを介してマシンに再接続できるかどうかを指定します。
smartcard_enabled サブ要素はブール値(true または false)で、クライアントに接続されているスマートカードが仮想マシンに渡されるかどうかを指定します。デフォルトは false です。
| |
Cluster id= | GUID | 仮想マシンのホストクラスターへの参照。 | 
|
template id= | GUID | この仮想マシンのベースとなるテンプレートへの参照。 |
|
domain id= | GUID | 仮想マシンのドメインへの参照。 |
|
start_time | xsd:dateTime 形式： YYYY-MM-DDThh:mm:ss | この仮想マシンが開始された日時。 |
|
stop_time | xsd:dateTime 形式： YYYY-MM-DDThh:mm:ss | この仮想マシンが停止された日時。 |
|
creation_time | xsd:dateTime 形式： YYYY-MM-DDThh:mm:ss | この仮想マシンが作成された日時。 |
|
origin | 2009、ovirt 、 vmware、または xenのいずれか | この仮想マシンの発信元のシステム。 |
|
stateless | ブール値：true または false | 仮想マシンがステートレスの場合は true。ステートレス仮想マシンには、起動時に取得され、シャットダウン時に削除されるディスクイメージのスナップショットが含まれます。これは、再起動後の状態の変更は維持されないことを意味します。 | |
delete_protected | ブール値：true または false | true に設定すると、仮想マシンは削除できません。 | |
sso | string | 仮想マシンのシングルサインオンの方法への参照。ip 属性を持つ method 要素が含まれます。 | |
placement_policy | complex | 仮想マシンの移行の配置ポリシーを設定します。デフォルトの host= と アフィニティー が必要です( migratable、user_migratable、または pinnedのいずれか)。host 要素は空のままにして、優先ホストを設定しないようにします。複数の host 要素を使用して、クラスター内で優先ホストのサブセットを指定します。 | |
memory_policy | complex | 仮想マシンのメモリーポリシーを設定します。仮想マシンを実行できるように、ホスト上の 保証 メモリーの最小量を定義します。 | |
quota id= | GUID | 仮想マシンのクォータを設定します。 | |
custom_properties | complex | カスタムスクリプトにパラメーターとして渡されるユーザー定義の環境変数のセット。各 custom_property には、name および value 属性が含まれます。列挙値のリストは、機能 で利用できます。 | |
usb | complex | 仮想マシンの USB ポリシーを定義します。enabled 要素はブール値に設定し、type 要素は native または legacy のいずれかに設定する必要があります。
重要
Legacy USB オプションは非推奨となり、Red Hat Virtualization 4.1 で削除されます。
| |
migration_downtime | integer | ライブマイグレーション中に仮想マシンがダウンできる最大ミリ秒数を表します。値が 0 の場合は、VDSM のデフォルトが使用されます。 | |
cpu_profile id= | GUID | 仮想マシンの cpu プロファイルへの参照。 | |
next_run_configuration | ブール値：true または false | 仮想 マシンの設定への変更が仮想マシンが次回の再起動時に適用される場合は True。 | |
numa_tune_mode | string | ホスト NUMA ノードのメモリー割り当てモード（をインターリーブ、厳格、または 優先する）への参照。 | |
guest_info | complex | ゲストクライアント情報への参照。address= 属性を持つ ip 要素が含まれます。 |
|
vmpool | complex | 仮想マシンプールへの参照。この要素は、プールの仮想マシン部分にのみ表示されます。 |
|
timezone | tz データベース形式： エリア/場所 | Windows 仮想マシンの Sysprep タイムゾーン設定。 | |
domain | complex | Windows 仮想マシンの Sysprep ドメイン設定。ドメイン コレクションからの 名前 が必要です。 | |
initialization | complex |
Linux ベースの仮想マシンに Cloud-Init を使用して起動時に仮想マシンに適用される値の一覧、または Windows ベースの仮想マシンの場合は Sysprep を定義します。
| |
payloads | complex |
起動時にコンテンツを仮想マシンに提供する
payload 要素のセットを定義します。各 ペイロード には、cdrom または floppy のいずれかの type 属性と file 要素のセットが必要です。各 file 要素内では、ファイルの名前と場所を指定する name 要素と、ファイルに配信する コンテンツ を定義する content 要素があります。
payloads 要素は、cloud-init 機能によって使用されます。cloud-init を使用して仮想マシンを設定する場合、ペイロードは type 属性を cd-rom に設定し、2 つの ファイル サブ要素 openstack/latest/meta_data.json および openstack/latest/user_data を使用して自動的に作成されます。これは、設定パラメーターを仮想マシンに渡します。
|
ステータス には、未割り当て の , down , up ,powering_up ,powered_down ,paused,migrating_from,migrating_to,unknown,not_responding の列挙値のいずれかが含まれます。 wait_for_launch,reboot_in_progress,saving_state,restoring_state,suspended,image_illegal,image_locked or powering_down.これらの状態は、capabilities の vm_states に一覧表示されます。
