跳转到主要内容
POST
运行自动化规则

限制说明

使用说明

  • 手动运行不要求规则处于启用状态。规则配置无效(例如使用了规则作用域不允许的 BYOC 运行器),或唯一启用的触发器是作战室触发器(这类规则没有 Web 控制台运行)时,会在创建运行前返回 400。
  • 创建者已离开账户的个人规则会被自动停用,本调用返回 400。
  • 同一规则每分钟最多手动运行一次;窗口内的第二次调用返回 429,code 为 "RequestTooFrequently"。
  • 管理权限:个人规则(team_id=0)仅创建者可管理;团队规则仅该团队成员可管理。账户所有者和管理员没有例外,需加入该团队。
  • 同一规则正在执行另一次更新、删除或手动运行时,本调用返回 HTTP 423,code 为 "RequestLocked",请稍后重试。
  • 调用在 Agent 会话启动后即返回,不等待运行结束。可用列出自动化运行记录(trigger_kind=manual)查询完成情况。
  • 对在 IM 群聊中运行的规则(execution_place=im),响应不包含 run.session_id。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

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

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