第17章 テンプレート
17.1. 仮想マシンテンプレート要素
templates コレクションは、Red Hat Virtualization 環境の仮想マシンテンプレートに関する情報を提供します。API ユーザーは、エントリーポイント URI から取得した rel="templates" リンクを使用してこの情報にアクセスします。
All-Content: true ヘッダーを使用して GET リクエストに関する追加情報を取得できます。
以下の表は、仮想マシンテンプレートのリソース表現に含まれる特定の要素を示しています。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
link rel="disks" | 関係 | 仮想マシンテンプレートリソースの disks サブコレクションへのリンク。 | 
|
link rel="nics" | 関係 | 仮想マシンテンプレートリソースの nics サブコレクションへのリンク。 | |
link rel="cdroms" | 関係 | 仮想マシンテンプレートリソースの cdroms サブコレクションへのリンク。 |
|
link rel="permissions" | 関係 | 仮想マシンテンプレートの パーミッション のサブコレクションへのリンク。 | |
type | 列挙 | テンプレートが提供する仮想マシンのタイプ。列挙値のリストは、機能 で利用できます。 | |
status | illegal、locked、または okのいずれか | テンプレートのステータス。これらの状態は capabilities の template_states に一覧表示されます。 |
|
memory | integer | ゲストに割り当てられるメモリーの量（バイト単位）。 | |
cpu | complex | ゲストで利用可能な CPU トポロジー ( ソケット と コア数) | |
os type= | 文字列( RHEL5 または WindowsXPなど) | ゲストオペレーティングシステムのタイプ。 | |
OS boot dev= | 列挙 | ブート要素の dev 属性によって記述される ブート デバイスの一覧。列挙値のリストは、機能 で利用できます。 | |
OS カーネル | string | テンプレートが起動するように設定されているカーネルイメージへのパス。 | |
OS initrd | string | 上記のカーネルで使用する initrd イメージへのパス。 | |
OS cmdline | string | 上記のカーネルで使用するカーネルコマンドラインパラメーター文字列。 | |
Cluster id= | GUID | テンプレートのホストクラスターへの参照。 | 
|
vm id= | GUID | このテンプレートのベースとなる仮想マシンへの参照。 | 
|
domain id= | GUID | テンプレートのドメインへの参照。 |
|
creation_time | xsd:dateTime 形式： YYYY-MM-DDThh:mm:ss | このテンプレートが作成された日時。 |
|
origin | 2009、ovirt 、 vmware、または xenのいずれか | このテンプレートの発信元のシステム。 |
|
high_availability | complex | ホストがクラッシュした場合に仮想マシンを自動的に再起動する必要がある場合は、enabled を true に設定します。priority 要素は、仮想マシンが再起動される順序を制御します。 | |
display | complex | ディスプレイ タイプ ( vnc または spiceのいずれか)、port、および モニター の数。allow_reconnect ブール値は、クライアントがディスプレイを介してマシンに再接続できるかどうかを指定します。 | |
stateless | ブール値：true または false | ステートレステンプレートには、起動時に取得され、シャットダウン時に削除されるディスクイメージのスナップショットが含まれます。これは、再起動後の状態の変更は維持されないことを意味します。 | |
usb | complex | 仮想マシンテンプレートの USB ポリシーを定義します。enabled 要素はブール値に設定し、type 要素は native または legacy のいずれかに設定する必要があります。
重要
Legacy USB オプションは非推奨となり、Red Hat Virtualization 4.1 で削除されます。
| |
placement_policy | complex | 仮想マシンの移行の配置ポリシーを設定します。デフォルトの host= と アフィニティー が必要です( migratable、user_migratable、または pinnedのいずれか)。host 要素は空のままにして、優先ホストを設定しないようにします。 | |
custom_properties | complex | カスタムスクリプトにパラメーターとして渡されるユーザー定義の環境変数のセット。各 custom_property には、name および value 属性が含まれます。列挙値のリストは、機能 で利用できます。 | |
timezone | tz データベース形式： エリア/場所 | Windows 仮想マシンテンプレートの Sysprep タイムゾーン設定。 | |
domain | complex | Windows 仮想マシンテンプレートの Sysprep ドメイン設定。ドメイン コレクションからの 名前 が必要です。 |
