POST管理接口

测试存储后端

用已保存的配置写入一个探测文件、以 Range 读回并删除,再写入并校验一个 2MB(设置了分片时为 分片大小)的文件。存储不可用也返回 200,原因写在 `error` 里;`range_supported` 为 false 时 分片缓存与断点下载不可用;`large_write_ok` 为 false 说明单次请求体受限(如宝塔 WAF),需要 设置或调小分片大小。

URL

/api/v1/admin/storage/backends/{id}/test

鉴权方式

需要管理员 JWT(Authorization: Bearer <token>)

请求参数

Path 参数

名称类型必填说明
idstring是

Header 参数

名称类型必填说明
Authorizationstring是Bearer <管理员 JWT 或 API Key>

该接口无需请求体。

响应示例

200 响应

{
  "ok": true,
  "range_supported": true,
  "large_write_ok": true,
  "latency_ms": 412,
  "error": null
}
POST

Try It Out

请求 URL 预览

/api/v1/admin/storage/backends/local/test