3.7.5. 分页
有些 Red Hat Virtualization 环境包含大量对象。通过一个请求检索所有这些请求并不实际，会损害性能。为了允许通过页面检索它们，搜索 参数支持可选 page 子 句。这与 max 参数相结合，是分页的基础。例如，要获得虚拟机的第一页，页面大小为 10 个虚拟机，请按如下所示发送请求：
GET /ovirt-engine/api/vms?search=page%201&max=10
注意
搜索参数是 URL 编码的，搜索 参数的实际值在编码前是第 1 页，因此这实际上正在请求第一页。
增加 页面 值以检索下一页：
GET /ovirt-engine/api/vms?search=page%202&max=10
page 子句可以和 search 参数内的其他子句搭配使用。例如，以下请求将返回虚拟机的第二页，但按名称排序：
GET /ovirt-engine/api/vms?search=sortby%20name%20page%202&max=10
重要
API 是无状态的；不能在不同请求之间保留状态，因为所有请求都是相互独立的。因此，如果您的请求之间发生状态更改，则页面结果可能会不一致。
例如，如果您从虚拟机列表中请求特定页面，并且在请求下一页之前创建或删除虚拟机，您的结果可能缺失，或者包含重复项。
