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