跳转到主要内容
列表接口分页返回结果。大多数接口使用页码分页;数据量大或变化快的集合还支持游标分页。每个接口支持哪些分页参数、上限和默认值是多少,以该接口页面为准——下文给出的是常见默认值,并非对所有接口都成立。

页码分页

请求参数

响应字段

示例

深度限制

On-call 的列表接口要求 p × limit 不超过 10,000,更深的页返回 400 InvalidParameter。如需继续往后取,请在接口支持时改用游标分页,或收窄筛选条件(例如缩短时间范围)。
两次调用之间如有数据新增或删除,偏移量会随之移动,页码分页可能漏掉或重复部分数据。需要完整、稳定地导出时请使用游标分页。

游标分页

把上一次响应中的 search_after_ctx 传回即可获取下一页。游标是不透明的:不要自行构造或修改,翻页过程中其他请求参数保持不变。传了 search_after_ctx 时 p 会被忽略。 在查询故障列表和查询告警列表上,可以先用页码分页、随时切换为游标分页:每个非空页都会同时返回 search_after_ctx,即该页最后一条之后的游标。

请求参数

响应字段

示例

支持 search_after_ctx 的接口

少数接口使用其他分页方式,详见其页面:查询跟进事项列表使用 cursor,部分 AI SRE 和监控接口使用 offset。

关于 total

total 不总是精确值。为保证大查询的响应速度,故障、告警、告警事件、复盘报告和映射数据相关的列表最多计数到 1,000:
  • 匹配数据少于 1,000 条时,total 是精确值。
  • 匹配数据达到或超过 1,000 条时,total 固定为 1,000,表示”1,000 条及以上”。
请用 has_next_page 而不是 total 判断是否还有下一页:has_next_page 不依赖 total,超过 1,000 条后仍然准确。