Skip to main content
POST
运行自动化规则

限制说明

使用说明

  • 同一规则的手动运行限速为每分钟最多一次;在此窗口内的第二次调用会返回 429,code 为 "RequestTooFrequently"。
  • 只有已启用的规则才能手动运行;已禁用或配置无效的规则会在创建运行前以 400 错误未通过预检。
  • 调用在底层 Agent 会话启动后即返回,而非等待运行结束;运行会继续异步执行——可使用列出自动化运行历史查询完成状态。
  • 以此方式发起的运行,trigger_kind 固定为 manual,在运行历史中与 schedule、http_post、oncall_incident 区分开来。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。

请求体

application/json
rule_id
string
必填

规则 ID,取自 POST /safari/automation/rule/list 返回的列表。

响应

成功

所有 Flashduty 公开 API 共用的标准响应结构。成功时 data 为接口专属载荷且不含 error;失败时 error 存在而 data 缺失。request_id 始终存在,并会同步写入 Flashcat-Request-Id 响应头。

request_id
string
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

手动运行一次自动化规则(跳过其计划触发时间)的结果。