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 是无状态的;因此无法在不同请求之间保持状态,因为所有请求都相互独立。因此,如果您的请求间更改了状态,则页面结果可能是不一致的。
例如,如果您从虚拟机列表请求特定页面,且在请求下一页前发生状态更改,那么您的结果可能会缺少条目或包含重复的条目。