跳转到主要内容
POST
恢复仪表盘

限制说明

使用说明

  • 只能恢复回收站中的仪表盘;其他仪表盘返回 DashboardNotFound(HTTP 404)。
  • expected_revision 必须等于该仪表盘在回收站中的当前版本号(即删除接口返回、回收站列表中显示的 revision),否则返回 DashboardRevisionConflict(HTTP 409)。
  • 省略 folder_id 表示恢复到原目录。若原目录已不存在,账户所有者与管理员会收到 RestoreFolderRequired(HTTP 409),需指定目标目录;其他成员只能恢复原目录仍可访问的仪表盘,否则返回 DashboardNotFound。
  • 目标目录不存在或无权访问时返回 FolderNotFound(HTTP 404)。恢复会使 revision 加 1。
  • 会记录审计日志。

授权

app_key
string
query
必填

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

请求体

application/json

恢复回收站中的仪表盘,可选恢复到其他目录。

dashboard_id
string
必填

仪表盘的 canonical UUIDv7。

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
expected_revision
integer<uint64>
必填

回收站中该仪表盘的当前版本号,即删除接口返回或回收站列表中显示的值。不一致时以 DashboardRevisionConflict 失败。

必填范围: x >= 1
folder_id
integer<uint64> | null

目标目录。省略或传 null 表示恢复到原目录;若原目录已不存在,调用会以 RestoreFolderRequired 失败,此时必须指定目标目录。

必填范围: x >= 1

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

已存储的仪表盘:包含标识、版本号、所在目录与完整定义。每次写入成功 revision 都会递增,下一次变更需把它作为 expected_revision 回传。