第 16 章 浮动磁盘
16.1. 浮动磁盘项
disks 集合提供了 Red Hat Enterprise Virtualization 环境中的磁盘的信息。用户可以把磁盘从任何虚拟机上取消关联，并把它们附加到其它虚拟机上，从而实现磁盘在不同虚拟机间“浮动”。API 用户可以通过从进入点 URI 获得的 rel="disks" 链接来访问这些信息。
以下表格包括了
disks 资源表述中的特定项的信息。
| 项 | 类型 | 描述 | 属性 |
|---|---|---|---|
link rel="statistics" | 关系 | 虚拟机磁盘统计数据的 statistics 子集合链接。 |
|
image_id | GUID | 保存在所定义的存储域中的虚拟机镜像标识。 |
|
storage_domains | 复杂数据 | 与磁盘相关联的存储域。每个 storage_domain 项都包括一个带有存储域 GUID 的 id 属性。使用 POST 更新这个项可以执行从一个数据存储域到另一个数据存储域的磁盘实时迁移操作。 |
|
size | 整数 | 磁盘大小（以字节为单位）。 |
|
provisioned_size | 整数 | 配置的磁盘大小（以字节为单位）。 |
|
actual_size | 整数 | 磁盘的实际大小（以字节为单位）。 |
|
status | illegal、invalid、locked 或 ok | 磁盘设备的状态。capabilities 下的 disk_states 列出了它的值。 |
|
interface | 列举 | 连接到磁盘设备的接口驱动类型。capabilities 包括了有效的值。 | |
format | 列举 | 底层的存储格式。capabilities 包括了有效的值。使用 Copy On Write（COW）可以创建快照，但对系统性能会有一些影响；Raw 不能创建快照，但可以提供更好的性能。 |
|
sparse | 布尔值：true 或 false | true：磁盘所使用的物理存储无法被预先分配。 |
|
bootable | 布尔值：true 或 false | true：磁盘被设为可引导。 | |
--shareable | 布尔值：true 或 false | true：磁盘可以被多个虚拟机共享。 | |
wipe_after_delete | 布尔值：true 或 false | 如果为 true，在磁盘被删除后，这个磁盘的底层物理存储会被清零。此选项会增加数据的安全性，但同时会消耗大量的操作资源，并会增加删除过程所需的时间。 | |
propagate_errors | 布尔值：true 或 false | true：当磁盘出现错误时，不会导致虚拟机暂停，而是把磁盘错误传递给虚拟机的 OS。 | |
quota id= | GUID | 为磁盘设置一个配额。 | |
lunStorage | 复杂数据 | 为存储使用的直接 LUN 的标识。需要一个包括 iSCSI 或 FCP 设备详情的 storage 项。 |
|
active | 布尔值 | 指定磁盘是否连接到虚拟机。 |
|
重要
基于名称对磁盘进行搜索需要
alias 搜索参数，而不是 name。
