查询数据库备份列表#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

列出数据库备份 Agent 主机备份目录中的备份文件（文件名、大小、修改时间、类型）。当前 Web 数据库备份页加载与触发备份后刷新都调用本操作。

使用位置#

页面/功能	角色或空间分支
数据库备份页列表	机构/管理员页面；Agent 签名鉴权

端点#

GET /agent-api/v1/db/backup/list — 列出已有数据库备份文件。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 agent · db-backup-list 列出已有数据库备份文件。

动线与完成判据#

status=200 且 data 数组可消费即读取结束；[] 为成功空态。列表只反映备份目录当前内容，不校验备份文件本身完整性。

错误与边界#

签名缺失/过期/不匹配按 Agent 鉴权出口拒绝（签名规则与时间窗见Agent 请求与鉴权）；技术错误为 Agent 通用失败信封。读取无副作用，签名窗口内可重试；窗口过期需重新取时间再签名。Web 在时间或 WASM 模块未就绪时静默等待。

调用关系与资源清理#

无长连接资源。触发备份成功后立即以新签名重读列表。

已知缺口#

Agent 部署环境（token prefix 配置值、反向代理、防火墙）与签名公式在 WASM 内部的实现一致性未联调核验（WASM 为编译产物，接口见）；mtime 取不到时的 0 值语义未联调。