4.22. vm
vm 资源类型对 Red Hat Virtualization 环境中的所有虚拟机资源进行分组。
| 名称 | 类型 | Description | 必填 | 用户 Creatable | User Updatable |
|---|---|---|---|---|---|
--name
|
字符串
|
虚拟机的名称
|
是
|
是
|
是
|
--template-id|name
|
字符串
|
对用作虚拟机基础的模板的引用。
|
是
|
是
|
否
|
--cluster-id|name
|
字符串
|
对包含此虚拟机的集群的引用。
|
是
|
是
|
是
|
--instance_type-id|name
|
字符串
|
定义实例类型。
指定自定义、大、medium、small、tiny 或 xlarge。
|
否
|
是
|
是
|
--quota-id
|
字符串
|
对虚拟机配额使用量的引用。
|
否
|
是
|
否
|
--timezone
|
字符串
|
Windows 虚拟机的 Sysprep 时区设置。
|
否
|
是
|
是
|
--os-boot
|
集合
|
虚拟机的引导设备。指定
cdrom、hd 或 网络。
|
否
|
是
|
是
|
--custom_properties-custom_property
|
集合
|
一组用户定义的环境变量，作为参数传递给自定义脚本。
|
否
|
是
|
是
|
--os-type
|
字符串
|
此虚拟机的操作系统类型。
|
否
|
是
|
是
|
--usb-enabled
|
布尔值
|
定义虚拟机的 USB 策略。设置为
true 以在虚拟机上启用 USB。
|
否
|
是
|
是
|
--usb-type
|
字符串
|
定义 USB 类型（如果启用）。
|
否
|
是
|
是
|
--type
|
字符串
|
定义虚拟机类型。指定
desktop 或 server。
|
否
|
是
|
是
|
--os-initRd
|
字符串
|
与指定内核一起使用的 initrd 镜像的路径。这个选项支持直接引导 Linux 内核，而不是通过 BIOS 引导装载程序引导。
|
否
|
是
|
是
|
--display-monitors
|
int
|
定义可用显示的数量。
|
否
|
是
|
是
|
--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 引导装载程序引导。
|
否
|
是
|
是
|
--cpu-topology-cores
|
int
|
虚拟机可用的 CPU 内核数。
|
否
|
是
|
是
|
--cpu-architecture
|
字符串
|
定义 CPU 架构。指定
x86_64、ppc64 或 未定义。
|
否
|
是
|
是
|
--memory
|
long
|
虚拟机的内存量，以字节为单位。
|
否
|
是
|
是
|
--memory_policy-guaranteed
|
long
|
在主机上保证最小内存量（以字节为单位），以便虚拟机运行。
|
否
|
是
|
是
|
--memory_policy-ballooning
|
布尔值
|
设置为
true 以启用内存气球设备。
|
否
|
是
|
是
|
--high_availability-priority
|
int
|
使用高可用性设置每个虚拟机的优先级值（迁移和重启顺序）。
|
否
|
是
|
是
|
--high_availability-enabled
|
布尔值
|
定义是否为虚拟机启用高可用性。
|
否
|
是
|
是
|
--domain-name
|
字符串
|
虚拟机的域名。
|
否
|
是
|
是
|
--description
|
字符串
|
虚拟机的描述。
|
否
|
是
|
是
|
--comment
|
字符串
|
虚拟机的评论。
|
否
|
是
|
是
|
--stateless
|
布尔值
|
如果虚拟机无状态，则设置为
true。无状态虚拟机包含引导时获取的磁盘镜像的快照，并在关机时删除。这意味着状态更改在重启后不会保留。
|
否
|
是
|
是
|
--permissions-clone
|
布尔值
|
设置为
true，以将源虚拟机的权限复制到模板。
|
否
|
是
|
是
|
--delete_protected
|
布尔值
|
设置为
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
|
字符串
|
随机数字生成器的来源。指定
random 或 hwrng。
|
否
|
是
|
是
|
--console-enabled
|
布尔值
|
设置为
true 以启用 VirtIO 控制台设备功能。
|
否
|
是
|
是
|
--cpu-mode
|
字符串
|
定义 CPU 模式。
指定自定义、host_model 或 host_passthrough。
|
否
|
是
|
是
|
--cpu-topology-sockets
|
int
|
虚拟机可用的 CPU 插槽数量。
|
否
|
是
|
是
|
--cpu_shares
|
int
|
虚拟机相对于其他虚拟机可能需要的 CPU 资源级别。例如
，512 代表低优先级虚拟机，1024 代表中等优先级虚拟机，2048 个高优先级虚拟机。
|
否
|
是
|
是
|
--placement_policy-affinity
|
字符串
|
每个虚拟机的迁移关联性。指定可
migratable、user_migratable 或 pinned。
|
否
|
是
|
是
|
--placement_policy-host-id|name
|
字符串
|
对迁移关联性的首选主机的引用。
|
否
|
是
|
是
|
--origin
|
字符串
|
虚拟机的源。指定
rhev 、 VMware 或 xen。
|
否
|
是
|
是
|
--os-kernel
|
字符串
|
为虚拟机配置的内核镜像的路径。这个选项支持直接引导 Linux 内核，而不是通过 BIOS 引导装载程序引导。
|
否
|
是
|
是
|
--disks-clone
|
布尔值
|
定义是否从定义的
模板 克隆磁盘。
|
否
|
是
|
否
|
--disks-disk
|
集合
|
对附加到虚拟机的磁盘引用。
|
否
|
是
|
是
|
--tunnel_migration
|
布尔值
|
设置为
true，以通过 libvirt 守护进程启用数据传输。隧道的传输使用更强大的加密算法，但会增加传输过程中的数据负载。
|
否
|
是
|
是
|
--migration_downtime
|
int
|
定义虚拟机在实时迁移期间可以停机的最大毫秒数。
|
否
|
是
|
是
|
--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。
|
否
|
是
|
是
|
--serial_number-policy
|
字符串
|
定义虚拟机模板的序列号策略。指定
主机、vm 或 自定义。如果使用 custom，也使用 --serial_number-value 定义序列号值。
|
否
|
是
|
是
|
--serial_number-value
|
字符串
|
定义虚拟机模板的序列号。
|
否
|
是
|
是
|
--bios-boot_menu-enabled
|
布尔值
|
设置为
true 以启用引导菜单。
|
否
|
是
|
是
|
--numa_tune_mode
|
字符串
|
定义如何为 NUMA 主机上的域进程分配内存。指定
interleave、严格 或 首选。如果未指定值，则参数默认为 strict。
|
否
|
是
|
是
|
--cpu_profile-id
|
字符串
|
定义要使用的 CPU 配置集。使用 list cpuprofiles 命令检索 CPU 配置集 ID 的完整列表。
|
否
|
是
|
是
|
--expect
|
'201-created'
|
请求会变得异步，直到返回预期的 HTTP 标头。对于长时间运行的任务，在任务完成之前，否则会返回的任务。
|
否
|
否
|
否
|
--correlation_id
|
字符串
|
用于跨系统日志记录的操作标记标识符。如果客户端没有定义标识符，则会生成一个。
|
否
|
是
|
否
|
--os-boot 参数是一个集合，其使用下表中的子参数。
| 名称 | 类型 | Description |
|---|---|---|
boot.dev
|
字符串
|
虚拟机模板的引导设备。指定
cdrom、hd 或 网络。
|
--custom_properties-custom_property 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
custom_property.name
|
字符串
|
自定义属性名称。
|
custom_property.value
|
字符串
|
自定义属性值。
|
--sso-methods-method 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
method.id
|
字符串
|
使用的单点登录方法：
GUEST_AGENT。
|
--disks-disk 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
disk.id
|
字符串
|
对虚拟磁盘的引用。
|
storage_domains.storage_domain
|
集合
|
为磁盘的存储域定义一组子参数。
|
--payloads-payload 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
payload.type
|
字符串
|
有效负载交付类型。指定
cdrom 或 floppy。
|
payload.file.name
|
字符串
|
有效负载文件名和虚拟机根文件系统中的位置。
|
payload.file.content
|
字符串
|
要提供给该文件的内容。
|
--cpu-cpu_tune-vcpu_pin 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
vcpu_pin.vcpu
|
int
|
要分配的虚拟 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
下表列出了虚拟机资源的操作。
| 操作 | Description |
|---|---|
start | 启动虚拟机。 |
stop | 停止虚拟机。 |
shutdown | 关闭虚拟机。 |
suspend | 暂停虚拟机。 |
detach | 从池中分离虚拟机。 |
migrate | 迁移虚拟机到另一主机上。 |
取消迁移 | 停止正在进行中的迁移。 |
export | 将虚拟机导出到导出存储域。 |
Move | 将虚拟磁盘移动到另一个存储域。 |
ticket | 为控制台访问创建一个 ticket。 |
logon | 启用用户登录，以使用第三方应用程序进行控制台访问。 |
