4.22. vm

vm 资源类型是所有虚拟机资源在 Red Hat Virtualization 环境中的组合。

表 4.58. 虚拟机参数

名称类型描述必需的用户可创建用户可更新
--name
字符串
虚拟机名
是
是
是
--template-id|name
字符串
虚拟机所基于的模板标识。
是
是
否
--cluster-id|name
字符串
指定主机所在的集群。
是
是
是
--instance_type-id|name
字符串
定义实例类型。指定 custom、large、medium、small、tiny 或者 xlarge。
否
是
是
--quota-id
字符串
虚拟机配额使用的标识。
否
是
否
--timezone
字符串
用于 Windows 虚拟机的 Sysprep 时区设置。
否
是
是
--os-boot
集合
虚拟机的引导设备。请指定 cdrom、hd 或者 network。
否
是
是
--custom_properties-custom_property
集合
用来自定义脚本的一组用户定义环境变量参数。
否
是
是
--os-type
字符串
虚拟机的操作系统类型。
否
是
是
--usb-enabled
布尔值
定义虚拟机的 USB 策略。如果设为 true，将在虚拟机上启用 USB 功能。
否
是
是
--usb-type
字符串
指定 USB 的类型（在 USB 已被启用的情况下）。
否
是
是
--type
字符串
指定虚拟机的类型，请指定 desktop 或者 server。
否
是
是
--os-initRd
字符串
到一个指定内核所使用的 initrd 镜像的路径。这个选项支持直接引导 Linux 内核，而不需要 BIOS bootloader。
否
是
是
--display-monitors
整数
定义可用的显示数量。
否
是
是
--display-single_qxl_pci
布尔值
设定为 true 以便使用单一虚拟 PCI 设备驱动多台显示器。
否
是
是
--display-type
字符串
定义显示类型，请指定 spice 或 vnc。
否
是
是
--display-allow_override
布尔值
设为 true 以便可以覆盖虚拟机控制台设置。
否
是
是
--display-smartcard_enabled
布尔值
设为 true 以便启用智能卡功能。
否
是
是
--display-file_transfer_enabled
布尔值
设为 true 以便启用 SPICE 文件传输。
否
是
是
--display-copy_paste_enabled
布尔值
设为 true 以便启用 SPICE 剪切版复制和粘贴。
否
是
是
--display-keyboard_layout
字符串
定义虚拟机键盘类型。只有使用 VNC 协议时这个选项才有效。请指定类似 en-US 的格式。
否
是
是
--os-cmdline
字符串
内核需要使用的内核命令行参数。这个选项支持直接引导一个 Linux 内核，而不需要使用 BIOS bootloader。
否
是
是
--cpu-topology-cores
整数
虚拟机可用的 CPU 内核数量。
否
是
是
--cpu-architecture
字符串
定义 CPU 架构。请指定 x86_64、ppc64 或者 undefined。
否
是
是
--memory
长整数
虚拟机的内存大小（以字节为单位）
否
是
是
--memory_policy-guaranteed
长整数
为了保证虚拟机的运行，在主机上最少需要保证具有的内存数量（以字节为单位）。
否
是
是
--memory_policy-ballooning
布尔值
设为 true 以便启用内存布尔设备。
否
是
是
--high_availability-priority
整数
设置虚拟机高可用性的优先级（如迁移和重启的顺序）。
否
是
是
--high_availability-enabled
布尔值
定义是否为该虚拟机启用高可用性。
否
是
是
--domain-name
字符串
虚拟机的域名。
否
是
是
--description
字符串
虚拟机的描述。
否
是
是
--comment
字符串
虚拟机的注释。
否
是
是
--stateless
布尔值
如果虚拟机处于无状态的（stateless），则将这个参数设为 true。无状态的虚拟机会在系统启动时对磁盘做一个快照，并在关机时删除对系统所做的所有改动。这意味着重启后会丢失对系统所做的改动。
否
是
是
--permissions-clone
布尔值
设为 true 以便将源虚拟机权限复制到模板中。
否
是
是
--delete_protected
布尔值
设为 true 以便无法删除使用此模板创建的虚拟机。
否
是
是
--sso-methods-method
集合
定义要使用的单点登录方法。例如：--sso-methods-method method.id=GUEST_AGENT。
否
是
是
--rng_device-rate-bytes
整数
指定每个周期中允许消耗的字节数。
否
是
是
--rng_device-rate-period
整数
以毫秒为单位指定周期时间。如果指定这个选项，则必须同时指定 --rng_device-rate-bytes。
否
是
是
--rng_device-source
字符串
随机数产生器的资源。请指定 random 或者 hwrng。
否
是
是
--console-enabled
布尔值
设为 true 以便启用 VirtIO 控制台设备功能。
否
是
是
--cpu-mode
字符串
定义 CPU模式。请指定 custom、host_model或者 host_passthrough。
否
是
是
--cpu-topology-sockets
整数
虚拟机可用的 CPU 插槽数量。
否
是
是
--cpu_shares
整数
相比其他虚拟机可要求的 CPU 资源水平。例如：低优先级虚拟机使用 512，中等优先级虚拟机使用 1024，而高优先级虚拟机使用 2048。
否
是
是
--placement_policy-affinity
字符串
每台虚拟机的迁移关联（migration affinity），请指定 migratable、user_migratable 或者 pinned。
否
是
是
--placement_policy-host-id|name
字符串
指定迁移关联（migration affinity）中优先选择的主机。
否
是
是
--origin
字符串
虚拟机原形。请指定 rhev、vmware 或者 xen。
否
是
是
--os-kernel
字符串
到虚拟机引导内核镜像的路径。这个选项支持直接引导 Linux 内核，而不需要 BIOS bootloader。
否
是
是
--disks-clone
布尔值
指定是否从 template 中克隆磁盘。
否
是
否
--disks-disk
集合
请参考附加到该虚拟机的磁盘。
否
是
是
--tunnel_migration
布尔值
设为 true 启用使用 libvirt 守护进程进行数据传输的功能。隧道传输使用更强大的加密算法，但会增加传输过程中的数据负载。
否
是
是
--migration_downtime
整数
以毫秒为单位定义在实时迁移过程中虚拟机可以停机的最长时间。
否
是
是
--virtio_scsi-enabled
布尔值
设为 true 以便在该虚拟机中添加 VirtIO 控制台设备。
否
是
是
--soundcard_enabled:
布尔值
设为 true 以便启用声卡。
否
是
是
--payloads-payload
集合
指定在虚拟机引导时发送到虚拟机的内容。
否
是
是
--initialization-configuration-type
字符串
定义虚拟机格式。只接受 ovf。
否
是
是
--initialization-configuration-data
字符串
这个参数必须与 --initialization-configuration-type 参数匹配。只接受 ovf。
否
是
是
--cpu-cpu_tune-vcpu_pin
集合
定义将虚拟机的哪个虚拟 CPU 与主机的物理 CPU 固定（pin）。
否
是
是
--serial_number-policy
字符串
定义虚拟机模板的序列号策略。请指定 host、vm 或者 custom。如果使用 custom，则还要使用 --serial_number-value 定义序列号。
否
是
是
--serial_number-value
字符串
定义虚拟机模板的序列号。
否
是
是
--bios-boot_menu-enabled
布尔值
设为 true 以便启用引导菜单。
否
是
是
--numa_tune_mode
字符串
定义如何在 NUMA 主机中为域进程分配内存。请指定 interleave、strict 或者 preferred。如果没有给定任何值，则该参数默认使用 strict。
否
是
是
--cpu_profile-id
字符串
定义要使用的 CPU 配置文件。请使用 list cpuprofiles 命令查询 CPU 配置文件 ID 的完整列表。
否
是
是
--expect
'201-created'
在所期望的 HTTP 头返回前，请求以异步的方式进行处理。它对需要长时间来执行的任务非常有用，可以防止在任务完成前返回成功信号。
否
否
否
--correlation_id
字符串
一个跨系统日志操作的标识。如果客户端没有定义这个标识，系统将会自动产生一个。
否
是
否
--os-boot 参数是使用下表中子参数的集合。

表 4.59. --os-boot parameters

名称类型描述
boot.dev
字符串
虚拟机模板的引导设备。请指定 cdrom、hd 或者 network。
--custom_properties-custom_property 参数是一个使用下表中的子参数的集合。

表 4.60. --custom_properties-custom_property 参数

名称类型描述
custom_property.name
字符串
自定义属性名。
custom_property.value
字符串
自定义属性的值。
--vm-disks-disk 参数是使用下表中子参数的集合。

表 4.61. --sso-methods-method parameters

名称类型描述
method.id
字符串
要使用的单点登录方法。例如：GUEST_AGENT。
--disks-disk 参数是使用下表中子参数的集合。

表 4.62. --disks-disk parameters

名称类型描述
disk.id
字符串
虚拟机磁盘的标识。
storage_domains.storage_domain
集合
为磁盘存储域定义一组子参数。
--payloads-payload 参数是一个使用下表中的子参数的集合。

表 4.63. --payloads-payload 参数

名称类型描述
payload.type
字符串
payload 的分发类型。请指定 cdrom 或 floppy。
payload.file.name
字符串
payload 文件在虚拟机引导文件系统中的文件名和位置。
payload.file.content
字符串
payload 文件的内容。
--cpu-cpu_tune-vcpu_pin 参数是一个使用下表中的子参数的集合。

表 4.64. --cpu-cpu_tune-vcpu_pin

名称类型描述
vcpu_pin.vcpu
整数
分配的虚拟 CPU。
vcpu_pin.cpu_set
字符串
主机上的物理 CPU。

例 4.45. 创建一个新虚拟机

[RHEVM shell (connected)]# add vm --name MyVM --template-name Blank --cluster-name Default --memory 536870912

例 4.46. 更新一个虚拟机。

[RHEVM shell (connected)]# update vm MyVM --memory 1073741824

例 4.47. 删除一个虚拟机

[RHEVM shell (connected)]# remove vm MyVM
下表列出了针对一个虚拟机资源的操作。

表 4.65. 虚拟机操作

操作描述
start启动一个虚拟机。
stop停止一个虚拟机。
shutdown关闭虚拟机。
suspend挂起一个虚拟机。
detach把虚拟机从虚拟机池中移出。
migrate将虚拟机迁移到另一台主机。
cancelmigration停止正在进行的迁移。
export将虚拟机导出到导出存储域
move把虚拟机磁盘移到另一个存储域中。
ticket为控制台访问创建一个 ticket。
logon使用第三方应用程序启用用户登录以便访问控制台。