6.217. StorageDomainVms
列出导出存储域的虚拟机.
例如,要检索存储域中可用且标识符为 123
的虚拟机,发送以下请求:
GET /ovirt-engine/api/storagedomains/123/vms
这将返回以下响应正文:
<vms> <vm id="456" href="/api/storagedomains/123/vms/456"> <name>vm1</name> ... <storage_domain id="123" href="/api/storagedomains/123"/> <actions> <link rel="import" href="/api/storagedomains/123/vms/456/import"/> </actions> </vm> </vms>
这些集合中的虚拟机和模板与顶级 Vm 和模板集合中的对应方表示相似,但它们还包含 StorageDomain 参考和 导入操作。
名称 | 概述 |
---|---|
| 返回导出存储域的虚拟机列表。 |
6.217.1. 列出 GET
返回导出存储域的虚拟机列表。
虚拟机返回列表的顺序无法保证。
名称 | 类型 | 方向 | 概述 |
---|---|---|---|
| in | 指明应遵循哪些内联链接。 | |
| in | 设置要返回的最大虚拟机数量。 | |
| in | 指明要检索包含存储域中磁盘的已注册或未注册虚拟机的列表。 | |
| out |
6.217.1.1. follow
指明应遵循哪些内联链接。这些链接引用的对象将在当前请求中获取。详情请查看此处。
6.217.1.2. Max
设置要返回的最大虚拟机数量。如果未指定,则返回所有虚拟机。
6.217.1.3. unregistered
指明要检索包含存储域中磁盘的已注册或未注册虚拟机的列表。要获得未注册的虚拟机列表,调用应指示未注册的标志。例如,要获得未注册虚拟机的列表,REST API 调用应如下所示:
GET /ovirt-engine/api/storagedomains/123/vms?unregistered=true
unregisterd 标志的默认值为 false
。请求仅适用于附加的存储域。