查询告警事件列表
告警管理
查询告警事件列表
通过游标或页码分页返回指定告警的原始事件。
POST
查询告警事件列表
限制说明
| 项目 | 说明 |
|---|---|
| 速率限制 | 每个账户 1,000 次/分钟;50 次/秒 |
| 权限要求 | 协作空间查看(on-call) |
使用说明
- 默认按最新事件优先返回;设置
asc=true可按最早事件优先读取。 - 使用上次响应中的
search_after_ctx搭配limit获取下一页。 - 也支持通过
p使用页码分页,但p * limit必须在 10,000 条以内。 - 单条告警可能累积大量原始事件,热点告警建议优先使用游标分页。
授权
在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。
请求体
application/json
告警 ID(MongoDB ObjectID)。
Pattern:
^[0-9a-fA-F]{24}$为 true 时按最早事件优先返回;默认按最新事件优先返回。
分页大小,默认 20,最大 100。
必填范围:
0 <= x <= 100页码,从 1 开始;未传 search_after_ctx 时生效。
必填范围:
x >= 0上一页响应返回的游标;传入后使用游标分页而非页码分页。
Pattern:
^[0-9a-fA-F]{24}$