6.119.2. 列出 GET
获取所有可用主机的列表。
例如，列出发送以下请求的主机：
GET /ovirt-engine/api/hosts
响应正文类似如下：
<hosts>
<host href="/ovirt-engine/api/hosts/123" id="123">
...
</host>
<host href="/ovirt-engine/api/hosts/456" id="456">
...
</host>
...
</host>
只有 search 参数中包含 sortby 子句时，才会保证返回的主机列表的顺序。
| 名称 | 类型 | 方向 | 概述 |
|---|---|---|---|
|
| in | 指明是否应将主机的所有属性包含在响应中。 | |
|
| in |
指明是否应该在考虑大小写的情况下使用 | |
|
| in |
此参数可与 | |
|
| in | 指明是否应根据用户的权限过滤结果。 | |
|
| in | 指明应遵循哪些内联链接。 | |
|
| out | ||
|
| in | 设置要返回的最大主机数。 | |
|
| in | 接受以逗号分隔的虚拟机 ID 列表，并返回可迁移到这些虚拟机的主机。 | |
|
| in | 用于限制返回的主机的查询字符串。 |
6.119.2.1. all_content
指明是否应将主机的所有属性包含在响应中。
默认情况下，排除以下主机属性：
-
hosted_engine
例如，要检索主机的完整表示法：
GET /ovirt-engine/api/hosts?all_content=true
这些属性默认不包含在内，因为检索它们会影响性能。它们很少使用，需要对数据库进行其他查询。谨慎使用此参数，且仅在有特殊需要时才使用。
