模型 / 模型重建 模块对应接口)。DELETE /... 接口默认是软删进入回收站,可恢复;私有化版本对每个项目单独维护回收站文件的"自动清理保留天数",超过该天数后系统自动永久清理,POST /trash-config 是项目级配置。POST /trash-files/restore 和 POST /trash-files 被服务端接收后立即 200 返回,实际操作在后台异步执行,客户端无法通过响应判断最终成败,需要通过 GET /trash-files 列表接口刷新确认。FileTypeDirLive)、2D 实时建图目录(FileTypeConstruction)、组织数据目录(FileTypeDirDataHub)三类,调用 DELETE /files/{id}/direct 会被拒绝。/model/.../trash-* 接口;模型文件的"恢复 / 永久删除"通过模型通用文件接口的 restore / destroy 参数实现(参见 模型教程)。本模块只暴露磁盘统计。获取媒体回收站文件列表 (GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/trash-files) — 当前项目媒体回收站中的文件列表,支持按文件名关键字过滤、按文件类型筛选、分页浏览,以及在已删文件夹内向下浏览子项。从回收站恢复文件 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/trash-files/restore) — 把回收站中的指定文件 / 文件夹批量恢复到原位置;如原父文件夹也被删除,则恢复到项目根目录。请求体形态 { "ids": [<int64>...], "select_all": <bool> },ids 与 select_all 互斥:传 ids 时按精确列表恢复;select_all=true 时按当前过滤条件恢复全部回收站文件。永久删除回收站文件 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/trash-files) — 批量从存储中永久删除,不可恢复。请求体形态与恢复接口一致:{ "ids": [<int64>...], "select_all": <bool> },二者互斥。单文件的"从回收站恢复"也可通过 更新媒体文件信息(PUT /media/api/v1/workspaces/{workspace_id}/files/{id}) 传restore=true完成,详见媒体教程。
获取媒体回收站配置 (GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/trash-config) — 当前项目媒体回收站的自动清理策略,未设置过的项目返回默认 值 30 天。修改媒体回收站配置 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/trash-config) — 更新保留天数策略;超过该天数的文件会被自动永久清理。单条硬删媒体文件 (DELETE /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/files/{id}/direct) 对单个媒体文件或文件夹直接从存储中永久删除(不进入回收站,不可恢复)。受保护的目录类型(直播录制目录、2D 实时建图目录、组织数据目录)不允许删除。与 媒体教程中的DELETE /files/direct(批量硬删)成对存在;前者按 ID 操作,后者按列表批量。
| 用途 | 接口 |
|---|---|
| 媒体回收站磁盘占用统计(按文件类型) | GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/drive-statistics-trash |
| 模型库回收站磁盘占用统计(按文件类型) | GET /openapi/v2.0/model/api/v1/workspaces/{workspace_id}/drive-statistics-trash |