跳转到主要内容
POST
移动告警规则到文件夹

限制说明

使用说明

  • dest_folder_id 必须是已存在的文件夹,且调用者须对该文件夹有管理权限(账户所有者或管理员、该文件夹或其上级文件夹的创建者,或绑定到该文件夹或其上级文件夹的团队成员);否则整个调用返回 AccessDenied,不会移动任何规则。
  • 结果按请求顺序为每个 ID 返回一项。移动成功的规则 message 为本地化的成功文案(Move successfully / 移动成功);未移动的规则保留在原文件夹,message 为错误信息。
  • 目标文件夹已有同名规则、调用者对规则当前所在文件夹无管理权限,或 ID 不存在(此时 name 为 id: <id>)时,该规则不会被移动。
  • 每次调用都会记录到账户审计日志,请不要把敏感信息放在请求字段中。

授权

app_key
string
query
必填

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

请求体

application/json
ids
integer<uint64>[]
必填

要移动的规则 ID 列表,包含 1 到 100 个 ID。

Required array length: 1 - 100 elements
dest_folder_id
integer<uint64>
必填

目标文件夹 ID,可通过 POST /monit/folder/list 获取。不能为 0;文件夹不存在或调用者对其无管理权限时,整个调用返回 AccessDenied。

响应

成功

成功响应结构。2xx 响应中 request_id 标识本次调用(同时出现在 Flashcat-Request-Id 响应头中),data 为接口业务 payload。失败响应使用不同结构,参见 ErrorResponse。

request_id
string
必填

本次请求的唯一 ID,也会在 Flashcat-Request-Id 响应头中返回。反馈问题时请一并附上。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object[]

批量规则操作中每条规则的处理结果列表。