Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

7.3.9. 分页

一些 Red Hat Virtualization 环境包含大量资源集合。但是，API 仅显示一个对集合搜索查询的默认资源数量。要显示多于默认值，API 通过包含 page 命令的搜索查询将集合分开到 页面中。

例 7.6. 分页资源

这个示例在集合中分页资源。URL 编码的请求为：

GET /ovirt-engine/api/collection?search=page%201 HTTP/1.1
Accept: application/xml

增加 page 值以查看结果的下一页：

GET /ovirt-engine/api/collection?search=page%202 HTTP/1.1
Accept: application/xml

在搜索查询中使用 page 命令和其他命令。例如：

GET /ovirt-engine/api/collection?search=sortby%20element%20asc%20page%202 HTTP/1.1
Accept: application/xml

此查询在由所选元素排序的集合列表中显示第二个页面。

重要的

REST API 是无状态的；因此无法在不同请求之间保持状态，因为所有请求都相互独立。因此，如果您的请求间更改了状态，则页面结果可能是不一致的。

例如，如果您从虚拟机列表请求特定页面，且在请求下一页前发生状态更改，那么您的结果可能会缺少条目或包含重复的条目。