读取 Agent 服务器时间#

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

用途与场景#

读取数据库备份 Agent 所在主机的当前时间（毫秒）。当前 Web 数据库备份页以 60 秒轮询本操作，把返回时间作为签名 time 参数源，保证备份接口的签名时间窗口有效。Agent 是独立部署在数据库主机上的服务（不在中心后端仓库），本页为该服务的接口正本之一。

使用位置#

页面/功能	角色或空间分支
数据库备份页 60 秒轮询	机构/管理员页面；本操作本身免签名

端点#

GET /agent-api/v1/system/timestamp — 查询服务器系统时间戳。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 agent · system-timestamp 查询服务器系统时间戳。

动线与完成判据#

status=200 且 data 为可用毫秒时间即完成。Web 以该值充当下一次签名调用的 time，并 60 秒轮询保持新鲜。

错误与边界#

本端点自身无签名/时间窗校验；Agent 通用错误信封见触发数据库备份的边界说明。读取无副作用，可重试。

调用关系与资源清理#

无长连接资源。它是备份页其余三个 Agent 操作（备份列表/触发备份/下载备份）的前置时间源。

已知缺口#

Agent 部署环境（反向代理路径、监听端口、防火墙）未核验；Agent 服务未联调。