4.20. template
テンプレート リソースタイプは、Red Hat Virtualization 環境のすべての仮想マシンテンプレートをグループ化します。--vm-id|name および --name のみが必要です。オプションのパラメーターが指定されていない場合、テンプレートはテンプレートの作成に使用される仮想マシンから設定を継承します。
| Name | 型 | 説明 | 必須 | User Creatable | ユーザーアップデータ可能 |
|---|---|---|---|---|---|
--vm-id|name
|
string
|
テンプレートの基礎として使用される仮想マシンへの参照。
|
はい
|
はい
|
いいえ
|
--name
|
string
|
仮想マシンテンプレートの名前。
|
はい
|
はい
|
はい
|
--memory
|
long
|
仮想マシンテンプレートのメモリー量（バイト単位）。
|
いいえ
|
はい
|
はい
|
--cpu-topology-cores
|
int
|
仮想マシンテンプレートで利用可能な CPU コアの数。
|
いいえ
|
はい
|
はい
|
--high_availability-enabled
|
ブール値
|
仮想マシンテンプレートの高可用性を有効にするには、
true に設定します。
|
いいえ
|
はい
|
はい
|
--os-cmdline
|
string
|
定義されたカーネルで使用するカーネルコマンドラインパラメーター文字列。このオプションは、BIOS ブートローダー経由ではなく、Linux カーネルを直接起動することに対応します。
|
いいえ
|
はい
|
はい
|
--origin
|
string
|
仮想マシンテンプレートの起点。2009、
、または xen を指定します。
|
いいえ
|
はい
|
はい
|
--high_availability-priority
|
int
|
各仮想マシンテンプレートの高可用性の優先度の値（つまりブート順序）を設定します。
|
いいえ
|
はい
|
はい
|
--timezone
|
string
|
Windows 仮想マシンテンプレートの Sysprep タイムゾーン設定。
GMT+00:00 などの形式を指定します。
|
いいえ
|
はい
|
はい
|
--domain-name
|
string
|
仮想マシンテンプレートのドメイン名。
|
いいえ
|
はい
|
はい
|
--type
|
string
|
仮想マシンのタイプを定義します。
desktop または server のいずれかを指定します。
|
いいえ
|
はい
|
はい
|
--stateless
|
boolean
|
結果の仮想マシンがステートレスの場合は
true に設定します。ステートレス仮想マシンには、起動時に取得され、シャットダウン時に削除されるディスクイメージのスナップショットが含まれます。これは、再起動後の状態の変更は維持されないことを意味します。
|
いいえ
|
はい
|
はい
|
--delete_protected
|
boolean
|
このテンプレートで作成された仮想マシンを削除できないようにするには、
true に設定します。
|
いいえ
|
はい
|
はい
|
--sso-methods-method
|
コレクション
|
使用されるシングルサインオンメソッドを定義します。例：
--sso-methods-method method.id=GUEST_AGENT
|
いいえ
|
はい
|
はい
|
--rng_device-rate-bytes
|
int
|
期間ごとに使用できるバイト数を指定します。
|
いいえ
|
はい
|
はい
|
--rng_device-rate-period
|
int
|
期間をミリ秒単位で指定します。指定した場合は、
--rng_device-rate-bytes も指定する必要があります。
|
いいえ
|
はい
|
はい
|
--rng_device-source
|
string
|
乱数ジェネレーターのソース。
random または hwrng のいずれかを指定します。
|
いいえ
|
はい
|
はい
|
--console-enabled
|
boolean
|
VirtIO コンソールデバイス機能を有効にするには
true に設定します。
|
いいえ
|
はい
|
はい
|
--placement_policy-affinity
|
string
|
テンプレートから作成される各仮想マシンの移行アフィニティー。
migratable、user_migratable、または pin を指定し ます。
|
いいえ
|
はい
|
はい
|
--description
|
string
|
仮想マシンテンプレートの説明。
|
いいえ
|
はい
|
はい
|
--comment
|
string
|
仮想マシンテンプレートのコメント。
|
いいえ
|
はい
|
はい
|
--custom_properties-custom_property
|
コレクション
|
カスタムスクリプトへのパラメーターとして渡されるユーザー定義の環境変数のセット。
|
いいえ
|
はい
|
はい
|
--os-type
|
string
|
仮想マシンテンプレートのオペレーティングシステムタイプ。
|
いいえ
|
はい
|
はい
|
--os-boot
|
コレクション
|
仮想マシンテンプレートのブートデバイス。
cdrom、hd、または network を指定します。例： --os-boot boot.dev=hd
|
いいえ
|
はい
|
はい
|
--cpu-topology-sockets
|
int
|
仮想マシンテンプレートで利用可能な CPU ソケットの数。
|
いいえ
|
はい
|
はい
|
--cpu_shares
|
int
|
仮想マシンが他の仮想マシンと比較して要求できる CPU リソースのレベル。たとえば、優先度の低い仮想マシンの場合は
512、中優先度の仮想マシンの場合は 1024、優先度の高い仮想マシンの場合は 2048 です。
|
いいえ
|
はい
|
はい
|
--cpu-architecture
|
string
|
CPU アーキテクチャーを定義します。
x86_ 64、ppc64、または undefined を指定します。
|
いいえ
|
はい
|
はい
|
--os-kernel
|
string
|
作成される仮想マシンが起動するように設定されているカーネルイメージへのパス。このオプションは、BIOS ブートローダー経由ではなく、Linux カーネルを直接起動することに対応します。
|
いいえ
|
はい
|
はい
|
--display-type
|
string
|
表示タイプを定義します。
spice または vnc のいずれかを指定します。
|
いいえ
|
はい
|
はい
|
--display-monitors
|
int
|
利用可能な表示数を定義します。
|
いいえ
|
はい
|
はい
|
--display-single_qxl_pci
|
boolean
|
1 つの仮想 PCI デバイスを使用して複数のモニターを駆動するには、
true に設定します。
|
いいえ
|
はい
|
はい
|
--display-allow_override
|
boolean
|
テンプレートコンソール設定の上書きを許可するには、
true に設定します。
|
いいえ
|
はい
|
はい
|
--display-smartcard_enabled
|
boolean
|
仮想マシンのスマートカード機能を有効にするには
true に設定します。
|
いいえ
|
はい
|
はい
|
--display-file_transfer_enabled
|
boolean
|
SPICE ファイルの転送を有効にするには
true に設定します。
|
いいえ
|
はい
|
はい
|
--display-copy_paste_enabled
|
boolean
|
SPICE クリップボードのコピーと貼り付けを有効にするには
true に設定します。
|
いいえ
|
はい
|
はい
|
--display-keyboard_layout
|
string
|
仮想マシンのキーボードレイアウトを定義します。このオプションは、VNC プロトコルを使用する場合にのみ使用できます。
en-US などの形式を指定します。
|
いいえ
|
はい
|
はい
|
--os-initRd
|
string
|
指定したカーネルで使用する initrd イメージへのパス。このオプションは、BIOS ブートローダー経由ではなく、Linux カーネルを直接起動することに対応します。
|
いいえ
|
はい
|
はい
|
--usb-enabled
|
ブール値
|
仮想マシンで USB サポートを有効にするには、
true に設定します。このオプションは、SPICE プロトコルを使用する仮想マシンでのみ利用できます。
|
いいえ
|
はい
|
はい
|
--usb-type
|
string
|
USB サポートが有効な場合は、USB タイプを定義します。
Legacy または Native のいずれかを指定します。
重要
Legacy USB オプションは非推奨となり、Red Hat Virtualization 4.1 で削除されます。
|
いいえ
|
はい
|
はい
|
--tunnel_migration
|
boolean
| libvirt デーモンでデータトランスポートを有効にするには、true に設定します。トンネル化されたトランスポートは強力な暗号化アルゴリズムを使用しますが、トランスポート時のデータ負荷を増やします。
|
いいえ
|
はい
|
はい
|
--migration_downtime
|
int
|
ライブマイグレーション中に仮想マシンがダウンできる最大ミリ秒数を定義します。
|
いいえ
|
はい
|
はい
|
--virtio_scsi-enabled
|
boolean
|
VirtIO コンソールデバイスを仮想マシンにアタッチできるようにするには、
true に設定します。
|
いいえ
|
はい
|
はい
|
--soundcard_enabled:
|
boolean
|
サウンドカードを有効にするには
true に設定します。
|
いいえ
|
はい
|
はい
|
--vm-disks-disk
|
コレクション
|
テンプレートに割り当てられたディスクへの参照。
|
いいえ
|
はい
|
いいえ
|
--id
|
string
|
仮想マシンテンプレートの ID。
|
いいえ
|
はい
|
はい
|
--permissions-clone
|
boolean
|
ソース仮想マシンのパーミッションをテンプレートにコピーするには、
true に設定します。
|
いいえ
|
はい
|
はい
|
--version-version_name
|
string
| --version-base_template-id パラメーターで使用されます。サブテンプレートの名前を定義します。
|
いいえ
|
はい
|
はい
|
--version-base_template-id
|
string
|
root テンプレートとして使用するテンプレート ID を定義します。このテンプレートをルートテンプレートのサブテンプレートとして作成する場合に使用します。
|
いいえ
|
はい
|
はい
|
--cpu-cpu_tune-vcpu_pin
|
コレクション
|
ホストの物理 CPU に固定する仮想マシンの仮想 CPU を定義します。
|
いいえ
|
はい
|
はい
|
--serial_number-policy
|
string
|
仮想マシンテンプレートのシリアル番号ポリシーを定義します。
ホスト、仮想マシン、また は カスタム を指定します。custom を使用する場合は、--serial_number-value を使用してシリアル番号の値も定義します。
|
いいえ
|
はい
|
はい
|
--serial_number-value
|
string
|
仮想マシンテンプレートのシリアル番号を定義します。
|
いいえ
|
はい
|
はい
|
--bios-boot_menu-enabled
|
boolean
|
ブートメニューを有効にするには
true に設定します。
|
いいえ
|
はい
|
はい
|
--cluster-id
|
string
|
クラスター ID を指定して、使用するクラスターを定義します。
|
いいえ
|
はい
|
はい
|
--cluster-name
|
string
|
クラスター名を指定して、使用するクラスターを定義します。
|
いいえ
|
はい
|
はい
|
--cpu_profile-id
|
string
|
使用する CPU プロファイルを定義します。list cpuprofiles コマンドを使用して、 CPU プロファイル ID の完全なリストを取得します。
|
いいえ
|
はい
|
はい
|
--expect
|
'201-created'
|
リクエストは予想される HTTP ヘッダーが返されるまで非同期になります。タスクの完了前に成功として返される長時間実行されるタスクに役立ちます。
|
いいえ
|
はい
|
はい
|
--correlation_id
|
string
|
システム間のロギングに対するアクションのタグ付け識別子。クライアントが識別子を定義しない場合は、生成されます。
|
いいえ
|
はい
|
はい
|
--sso-methods-method パラメーターは、以下の表のサブパラメーターを使用するコレクションです。
| Name | 型 | 説明 |
|---|---|---|
method.id
|
string
|
使用されるシングルサインオンメソッド：
GUEST_AGENT
|
--custom_properties-custom_property パラメーターは、以下の表のサブパラメーターを使用するコレクションです。
| Name | 型 | 説明 |
|---|---|---|
custom_property.name
|
string
|
カスタムプロパティー名。
|
custom_property.value
|
string
|
カスタムプロパティーの値。
|
--os-boot パラメーターは、以下の表のサブパラメーターを使用するコレクションです。
| Name | 型 | 説明 |
|---|---|---|
boot.dev
|
string
|
仮想マシンテンプレートのブートデバイス。
cdrom、hd、または network を指定します。
|
--vm-disks-disk パラメーターは、以下の表のサブパラメーターを使用するコレクションです。
| Name | 型 | 説明 |
|---|---|---|
disk.id
|
string
|
仮想ディスクへの参照。
|
storage_domains.storage_domain
|
コレクション
|
ディスクのストレージドメインのサブパラメーターのセットを定義します。
|
--cpu-cpu_tune-vcpu_pin パラメーターは、以下の表のサブパラメーターを使用するコレクションです。
| Name | 型 | 説明 |
|---|---|---|
vcpu_pin.vcpu
|
int
|
割り当てる仮想 CPU。
|
vcpu_pin.cpu_set
|
string
|
ホスト上の物理 CPU。
|
例4.41 新規テンプレートの作成
[RHEVM shell (connected)]# add template --name MyTemplate1 --vm-name MyVM1
例4.42 テンプレートの更新
[RHEVM shell (connected)]# update template MyTemplate1 --memory 1073741824
例4.43 テンプレートの削除
[RHEVM shell (connected)]# remove template MyTemplate1
以下の表は、仮想マシンテンプレートリソースのアクションの一覧です。
| アクション | 説明 |
|---|---|
export | テンプレートをエクスポートストレージドメインにエクスポートします。 |
