Skip to content

端点

/api/repo/setRepoIndexRetentionDays

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

需要认证 需要管理员

接口描述

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

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

请求参数 (JSON Body)

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

返回值

参数名类型描述
codenumber返回码,0 表示成功
msgstring错误信息,成功时为空字符串。
datanull成功时固定为 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
}