第 17 章 模板
17.1. 虚拟机模板元素
templates 集合提供有关 Red Hat Virtualization 环境中的虚拟机模板的信息。API 用户通过从入口点 URI 获取的 rel="templates" 链接访问此信息。
可以使用
All-Content: true 标头检索 GET 请求的其他信息。
下表显示了虚拟机模板资源表示法中包含的特定元素。
| 元素 | 类型 | Description | Properties |
|---|---|---|---|
link rel="disks" | 关系 | 到虚拟机模板 资源的 disk 子集合的链接。 | 
|
link rel="nics" | 关系 | 虚拟机模板资源的 nics 子集合的链接。 | |
link rel="cdroms" | 关系 | 虚拟机模板资源的 cdroms 子集合的链接。 |
|
link rel="permissions" | 关系 | 到虚拟机模板 权限权限 子集合的链接。 | |
type | Enumerated | 模板提供的虚拟机类型。功能 中提供了枚举的值的列表。 | |
status | 其中一个 非法、锁定 或 正常 | 模板状态。这些状态列在 capabilities 下的 template_states 中。 |
|
内存 | 整数 | 分配给客户机的内存量，以字节为单位。 | |
cpu | complex | 可供客户机使用的 CPU 拓扑 （如 套接字 和 内核数量）。 | |
os type= | 字符串，如 RHEL5 或 WindowsXP | 客户机操作系统类型。 | |
OS 引导 dev= | Enumerated | 引导设备列表，由 引导 元素中的 dev 属性描述。功能 中提供了枚举的值的列表。 | |
OS 内核 | 字符串 | 配置为从中引导模板的内核镜像的路径。 | |
OS initrd | 字符串 | 与内核一起使用的 initrd 镜像的路径。 | |
OS cmdline | 字符串 | 与上述内核一起使用的内核命令行参数字符串。 | |
cluster id= | GUID | 对模板的主机集群的引用。 | 
|
vm id= | GUID | 对此模板所基于的虚拟机的引用。 | 
|
domain id= | GUID | 对模板的域的引用。 |
|
creation_time | xsd:dateTime 格式： YYYY-MM-DDTh:mm:ss | 创建此模板的日期和时间。 |
|
origin | rhev,ovirt,vmware 或 xen之一 | 此模板源自的系统。 |
|
high_availability | complex | 如果虚拟机在 主机崩溃时应自动重启，则设置为 true。priority 元素控制虚拟机重新启动的顺序。 | |
显示 | complex | 显示 类型 ( vnc 或 spice)、port 以及 监视器 的数量。allow_reconnect 布尔值指定客户端是否可以通过显示重新连接到机器。 | |
无状态 | 布尔值： true 或 false | 无状态模板包含引导时获取的磁盘镜像的快照，并在关机时删除。这意味着状态更改在重启后不会保留。 | |
usb | complex | 定义虚拟机模板的 USB 策略。要求将 enabled 元素设置为布尔值，并且 type 元素设为 native 或 legacy。
重要
Legacy USB 选项已弃用，并将在 Red Hat Virtualization 4.1 中删除。
| |
placement_policy | complex | 为虚拟机迁移设置放置策略。需要默认的 host= 和 关联性 （一个可 migratable、user_migratable 或 固定）。将 host 元素留空，以设置任何首选主机。 | |
custom_properties | complex | 一组用户定义的环境变量，作为参数传递给自定义脚本。每个 custom_property 都包含 name 和 value 属性。功能 中提供了枚举的值的列表。 | |
timezone | tz 数据库格式： Area/Location | Windows 虚拟机模板的 Sysprep 时区设置。 | |
domain | complex | Windows 虚拟机模板的 Sysprep 域设置。需要 域 集合中的 名称。 |
