7.3.7. 查询语法
API 使用 URI 模板来执行带有
GET 请求的搜索查询：
GET /ovirt-engine/api/collection?search={query} HTTP/1.1
Accept: application/xml
query 模板值引用 API 定向到 集合的 搜索查询。这个 查询 使用与 Red Hat Virtualization Query Language 相同的格式：
(criteria)[sortby (element) asc|desc]
sortby 子句是可选的，仅在排序结果时才需要。
| 集合 | 标准 | 结果 |
|---|---|---|
主机 | vms.status=up | 显示所有运行状态为 up 的虚拟机的主机的列表。 |
vms | domain=qa.company.com | 显示在指定域中运行的所有虚拟机的列表。 |
vms | users.name=mary | 显示属于用户名为 mary 的所有虚拟机的列表。 |
events | severity> 常规排序时间 | 显示所有严重性高于 normal 的事件 的列表，并根据 time element 值进行排序。 |
events | severity>normal sortby time desc | 显示所有严重性高于 normal 的 事件列表，并按 时间 元素值降序排列。 |
API 要求
查询 模板为 URL 编码，才能转换保留字符，如 operators 和空格。
例 7.3. URL 编码的搜索查询
GET /ovirt-engine/api/vms?search=name%3Dvm1 HTTP/1.1 Accept: application/xml
