清理工作区孤立文件与已删除卷

手动处理满足保留条件的孤立Catalog文件及已软删除卷。会删除实际文件对象和元数据,不是dry-run。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/garbage-collection

调用前准备

MOI_ENDPOINT 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

只由已确认目标环境和清理范围的维护人员执行。需要该工作区catalog.orphan_cleanup权限;不能用普通文件删除权限或平台管理员身份名称推断已授权。

请求参数

curl --request POST "$MOI_ENDPOINT/workspaces/$WORKSPACE_ID/garbage-collection" \
  --header "X-API-Key: $AI_STUDIO_API_KEY" --header "X-Workspace-ID: $WORKSPACE_ID" \
  --header "Content-Type: application/json" \
  --data '{"orphan_file_threshold_hours":720,"batch_size":100}'

参数

类型

必填

说明

orphan_file_threshold_hours

integer

否

文件创建后的最小年龄,小时;省略/非正默认720小时,即30天。正数可缩短默认保留期,非强制最少30天。能解码为int64但超过time.Duration小时范围时拒绝;超int64范围或类型错误可触发默认清理。

batch_size

integer

否

省略/非正默认100;孤立文件候选和已删除卷分别使用此批量上限,不是全工作区总删除上限。

兼容行为:空/无效JSON体会重置整个请求为默认值继续清理;未知字段不代表受支持,也不会提供dry-run。不要用错误body、0阈值或0批量来“先试一下”。完整副作用/恢复见清理语义。

成功响应

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "orphan_files_cleaned": 1,
    "deleted_volumes_cleaned": 2,
    "message": "Garbage collection completed successfully"
  }
}

字段

类型

说明

code

string

成功OK。

msg

string

成功OK。

data.orphan_files_cleaned

integer

data.deleted_volumes_cleaned

integer

data.message

string

错误响应

{
  "code": "ErrServer",
  "msg": "Internal Server Error"
}

字段

类型

说明

code

string

参数范围无效ErrParamInvalid,权限/依赖或内部失败按标准错误返回。

msg

string

错误信息。失败可能已有部分删除完成,没有全程事务回滚保证;响应不带已完成计数。

最后更新于