Appearance
端点
/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
}