6.286.2. 列出 GET

返回系统虚拟机的列表。

只有 search 参数中包含 sortby 子句时，才会保证虚拟机返回列表的顺序。

表 6.897. 参数摘要
名称	类型	方向	概述
`all_content`	布尔值	in	指明是否应将虚拟机的所有属性包含在响应中。
`case_sensitive`	布尔值	in	指明是否应该在考虑大小写的情况下使用 `search` 参数执行搜索。
`filter`	布尔值	in	指明是否应根据用户的权限过滤结果。
`follow`	字符串	in	指明应遵循哪些内联链接。
`max`	整数	in	要返回的最大结果数。
`ovf_as_ova`	布尔值	in	指明结果是否应该公开显示在该虚拟机的 OVA 文件中时的 OVF。
`search`	字符串	in	用于限制返回的虚拟机的查询字符串。
`vms`	Vm[]	out

指明是否应将虚拟机的所有属性包含在响应中。

默认情况下排除以下属性：

例如，要检索虚拟机的完整表示法，发送如下请求：

GET /ovirt-engine/api/vms?all_content=true

注意

不包含这些属性的原因是性能：它们很少被使用，需要额外查询数据库。因此，仅当真正需要时才尝试使用此参数。