← 返回首页
POST /api/repo/setRepoIndexRetentionDays

设置历史快照索引保留天数

需要认证 需要管理员

接口描述

设置当前工作空间（仓库）的本地历史快照索引的保留天数。索引是用于快速访问和检索历史版本的数据。设置一个合理的保留天数有助于平衡历史追溯能力和磁盘空间占用。

如果设置的天数小于 1，则系统会自动将其设置为默认的 180 天。

请求参数 (JSON Body)

参数名 类型 必需 描述
days number 是 要保留历史快照索引的天数。最小值为 1，如果小于 1 则默认为 180。

返回值

参数名 类型 描述
code number 返回码，0 表示成功
msg string 错误信息，成功时为空字符串。
data null 成功时固定为 null。
请求示例
返回示例

请求示例 (设置保留90天)

POST /api/repo/setRepoIndexRetentionDays HTTP/1.1
Host: 127.0.0.1:6806
Content-Type: application/json
Authorization: Token YOUR_API_TOKEN_HERE

{
  "days": 90
}

请求示例 (设置小于1天，将按默认180天处理)

POST /api/repo/setRepoIndexRetentionDays HTTP/1.1
Host: 127.0.0.1:6806
Content-Type: application/json
Authorization: Token YOUR_API_TOKEN_HERE

{
  "days": 0 
}

返回示例 (成功)

{
  "code": 0,
  "msg": "",
  "data": null
}

返回示例 (失败 - 未认证或无管理员权限)

{
  "code": -1, // 或 401, 403 等，具体根据服务端实现
  "msg": "API token is missing or invalid / Admin role required",
  "data": null
}

注意：这是一个社区维护的文档，可能与官方最新版本存在差异。

如果您觉得本文档有帮助，可以考虑赞助支持：爱发电

在线测试