跳转到主要内容
POST
创建监控目录

限制说明

使用说明

  • 传入 parent_id: 0 或省略该字段以创建根文件夹。要在某个父文件夹下创建,调用方必须有权修改它:账户所有者或管理员、该父文件夹或其任一祖先的创建者,或者被分配到该父文件夹或其任一祖先的团队成员。父文件夹不存在时返回 InvalidParameter,无权修改父文件夹时返回 AccessDenied。
  • 响应为新创建的文件夹。
  • 每次调用均记录账户审计日志。请勿在请求字段中传入密钥。

授权

app_key
string
query
必填

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

请求体

application/json

创建监控文件夹的请求。

name
string
必填

文件夹名称;必填,不能包含句点(.)、斜杠(/)或逗号(,)。

Minimum string length: 1
note
string

自由格式的备注。省略时为空。

parent_id
integer<uint64>

父文件夹 ID;为 0 或省略时创建根文件夹。调用方必须有权修改该父文件夹。

必填范围: x >= 0
team_id
integer<uint64>

文件夹所属团队的 ID;为 0 或省略表示不归属任何团队。团队成员可以查看和修改该文件夹及其下的全部内容。

必填范围: x >= 0

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

监控文件夹。文件夹构成一棵树;parent_path 是以逗号分隔的祖先 ID 列表,调用方可据此重建树并在客户端搜索。