红帽全球峰会4.22. vm
vm 资源类型是所有虚拟机资源在 Red Hat Enterprise Virtualization 环境中的组合。
| 名称 | 类型 | 描述 | 必需的 | 用户可创建 | 用户可更新 |
|---|---|---|---|---|---|
--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
|
整数
|
以毫秒为单位定义 live 迁移过程中虚拟机可以停机的最长时间。
|
否
|
是
|
是
|
--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 参数是使用下表中子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
boot.dev
|
字符串
|
虚拟机模板的引导设备。请指定
cdrom、hd 或者 network。
|
--custom_properties-custom_property 参数是一个使用下表中的子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
custom_property.name
|
字符串
|
自定义属性名。
|
custom_property.value
|
字符串
|
自定义属性的值。
|
--vm-disks-disk 参数是使用下表中子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
method.id
|
字符串
|
要使用的单点登录方法。例如：
GUEST_AGENT。
|
--disks-disk 参数是使用下表中子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
disk.id
|
字符串
|
虚拟机磁盘的标识。
|
storage_domains.storage_domain
|
集合
|
为磁盘存储域定义一组子参数。
|
--payloads-payload 参数是一个使用下表中的子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
payload.type
|
字符串
|
payload 的分发类型。请指定
cdrom 或 floppy。
|
payload.file.name
|
字符串
|
payload 文件在虚拟机引导文件系统中的文件名和位置。
|
payload.file.content
|
字符串
|
payload 文件的内容。
|
--cpu-cpu_tune-vcpu_pin 参数是一个使用下表中的子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
vcpu_pin.vcpu
|
整数
|
分配的虚拟 CPU。
|
vcpu_pin.cpu_set
|
字符串
|
主机上的物理 CPU。
|
例 4.44. 创建一个新虚拟机
[RHEVM shell (connected)]# add vm --name MyVM --template-name Blank --cluster-name Default --memory 536870912
[RHEVM shell (connected)]# add vm --name MyVM --template-name Blank --cluster-name Default --memory 536870912例 4.45. 更新一个虚拟机。
[RHEVM shell (connected)]# update vm MyVM --memory 1073741824
[RHEVM shell (connected)]# update vm MyVM --memory 1073741824例 4.46. 删除一个虚拟机
[RHEVM shell (connected)]# remove vm MyVM
[RHEVM shell (connected)]# remove vm MyVM
下表列出了针对一个虚拟机资源的操作。
| 操作 | 描述 |
|---|---|
start | 启动一个虚拟机。 |
stop | 停止一个虚拟机。 |
shutdown | 关闭虚拟机。 |
suspend | 挂起一个虚拟机。 |
detach | 把虚拟机从虚拟机池中移出。 |
migrate | 将虚拟机迁移到另一台主机。 |
cancelmigration | 停止正在进行的迁移。 |
export | 将虚拟机导出到导出存储域 |
move | 把虚拟机磁盘移到另一个存储域中。 |
ticket | 为控制台访问创建一个 ticket。 |
logon | 使用第三方应用程序启用用户登录以便访问控制台。 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}