创建告警规则
告警规则
创建告警规则
创建新的告警规则,返回带有分配 ID 的已创建规则。
POST
创建告警规则
限制说明
| 项目 | 说明 |
|---|---|
| 速率限制 | 每个账户 1,000 次/分钟;50 次/秒 |
| 权限要求 | 告警规则管理(monit) |
使用说明
name、ds_type、cron_pattern和rule_configs.queries为必填项。ds_list(支持通配符)或ds_ids必须有一个非空。cron_pattern使用标准 5 字段 cron 语法。channel_ids可为空,告警将通过全局集成路由。- 每次调用都会记录到账户审计日志,请不要把敏感信息放在请求字段中。
授权
在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。
请求体
application/json
完整的告警规则配置。
规则所属文件夹。
规则名称。
自定义标签。
数据源类型。
数据源名称模式(支持通配符)。
具体数据源 ID 列表。
规则评估配置。
5 字段 cron 调度。不允许以 CRON_TZ= 或 TZ= 开头,时区请填写到 timezone 字段。
告警规则执行时区,决定 cron 调度与生效时间窗口的解释方式。仅接受 IANA 时区名(如 Asia/Shanghai、UTC、Europe/London);不接受 Local、UTC+8、CST 等简写或偏移量。留空时按 Asia/Shanghai 处理。
规则生效的时间窗口。
可用选项:
text, markdown 告警发送到的协作空间 ID 列表。
通知重复间隔(秒)。
最大重复通知次数。