24.5. 对事件进行分页显示

虚拟环境会在一定时间内产生大量事件,而 API 只会为每个搜索查询显示默认数量的事件。要显示比默认数量更多的事件,可以在搜索查询中使用 page 命令,API 会根据这个命令把搜索结果进行分页。
以下的搜索查询使用一个 page 值和 sortby 子句告诉 API 对结果进行分页显示:
sortby time asc page 1
sortby 子句指定了基于哪个项对结果进行排序,以及排序的顺序(升序或降序)。在 events 搜索查询中,把排序所基于的项设置为 time,把排序的顺序设置为升序(asc),API 会显示您的虚拟环境被创建后的所有事件。
page 定义了页的数量,而每一页会包括默认数量的事件。分页从 page 1 开始。增加 page 的值可以显示更多页:
sortby time asc page 2
sortby time asc page 3
sortby time asc page 4

例 24.5. 对事件进行分页显示

这个实例对 event 资源进行分页。URL 编码的请求是:
GET /api/events?search=sortby%20time%20asc%20page%201 HTTP/1.1
Accept: application/xml
增加 page 的值来查看结果的下一页:
GET /api/events?search=sortby%20time%20asc%20page%202 HTTP/1.1
Accept: application/xml
使用 from 参数指定开始事件的 id
GET /api/events?search=sortby%20time%20asc%20page%202&from=30 HTTP/1.1
Accept: application/xml