第 17 章 模板
17.1. 虚拟机模板项
templates 集合提供了 Red Hat Enterprise Virtualization 环境中的虚拟机模板信息。API 用户可以通过从进入点 URI 获得的 rel="templates" 链接来访问这些信息。
使用带有
All-Content: true 头的 GET 请求可以获得额外信息。
以下表格包括了虚拟机模板表述中的特定项的信息。
| 项 | 类型 | 描述 | 属性 |
|---|---|---|---|
link rel="disks" | 关系 | 虚拟机模板资源的 disks 子集合。 |
|
link rel="nics" | 关系 | 虚拟机模板资源的 nics 子集合。 | |
link rel="cdroms" | 关系 | 虚拟机模板资源的 cdroms 子集合。 |
|
link rel="permissions" | 关系 | 虚拟机模板权限的 permissions 子集合。 | |
type | 列举 | 模板提供的虚拟机类型。capabilities 包括了有效值列表。 | |
status | illegal、locked 或 ok | 模板状态。这些状态在 capabilities 下面的 template_states 中列出。 |
|
memory | 整数 | 分配给虚拟机的内存大小（以字节为单位）。 | |
cpu | 复杂数据 | 虚拟机可用的 CPU topology（如 sockets 数量和 cores 数量）。 | |
os type= | 字符串，如 RHEL5 或 WindowsXP | 虚拟机操作系统类型。 | |
os boot dev= | 列举 | boot 项的 dev 属性所描述的引导设备列表。capabilities 包括了它的有效值。 | |
os kernel | 字符串 | 用来引导模板的内核镜像路径。 | |
os initrd | 字符串 | 以上内核使用的 initrd 镜像。 | |
os cmdline | 字符串 | 以上内核使用的内核命令行参数。 | |
cluster id= | GUID | 模板所属主机的集群标识。 |
|
vm id= | GUID | 模板所基于的虚拟机的标识。 |
|
domain id= | GUID | 模板域的标识。 |
|
creation_time | xsd:dateTime 格式：YYYY-MM-DDThh:mm:ss | 模板被创建的日期和时间。 |
|
origin | rhev、ovirt、vmware 或 xen | 模板的原始系统。 |
|
high_availability | 复杂数据 | 如果需要在虚拟机或它所在的主机出现系统故障时自动重启，请把 enabled 设置为 true。一个 priority 项被用来控制虚拟机重启的顺序。 | |
display | 复杂数据 | 显示的 type（vnc 或 spice）、端口以及显示器的数量。allow_reconnect 的值指定了客户端是否可以通过显示重新连接到机器上。 | |
stateless | 布尔值：true 或 false | 无状态模板会在系统启动时对磁盘做一个快照，并在关机时删除对系统所做的所有改变。这意味着每次对系统所做的改变会在系统重启后丢失。 | |
usb | 复杂数据 | 定义虚拟机模板的 USB 策略。需要一个 enabled 项（布尔值）和一个 type 项（值是 native 或 legacy）。 | |
placement_policy | 复杂数据 | 设置虚拟机迁移的替换策略。需要一个默认的 host= 和一个 affinity（migratable、user_migratable 或 pinned）。如果没有设置 host 项的值，则意味着没有首选的主机。 | |
custom_properties | 复杂数据 | 传递给脚本的一组用户自定义的环境变量。每个 custom_property 都包括 name 和 value 属性。capabilities 包括了有效值的列表。 | |
timezone | 时区数据库格式：Area/Location | Windows 虚拟机模板在 Sysprep 中的时区设置。 | |
domain | 复杂数据 | Windows 虚拟机模板在 Sysprep 中的时区设置。需要 domains 集合中的一个 name。 |
