feat(vfs): 增强虚拟文件系统删除和查询功能
- 新增递归删除目录及子项的功能,支持 recursive 和 force 操作模式 - 支持通过路径获取文件或目录内容,并完善参数说明和示例 - 完善 VFS API 文档,包括操作模式、权限描述和响应内容 - 优化 GetVFSNode 方法,改为通过 ID 查询节点信息 - 修复部分路径和权限检查的逻辑注释
This commit is contained in:
@ -73,13 +73,17 @@ paths:
|
||||
|
||||
/vfs/v1/files:
|
||||
parameters:
|
||||
- name: path
|
||||
in: query
|
||||
required: true
|
||||
description: 文件系统路径,例如 "documents/readme.txt" 或 "services/mysql.service" 或 "folder/"
|
||||
schema:
|
||||
type: string
|
||||
example: "readme.txt"
|
||||
- name: path
|
||||
in: query
|
||||
required: true
|
||||
description: |
|
||||
文件系统路径,例如:
|
||||
- "/documents/readme.txt" (文件路径)
|
||||
- "/services/sql.bk.api" (服务文件)
|
||||
- "/folder/" (目录路径,以/结尾)
|
||||
schema:
|
||||
type: string
|
||||
example: "/documents/readme.txt"
|
||||
|
||||
get:
|
||||
summary: 读取文件或列出目录
|
||||
@ -129,6 +133,7 @@ paths:
|
||||
text/plain:
|
||||
schema:
|
||||
type: string
|
||||
description: 文件内容, 或者服务内容
|
||||
responses:
|
||||
'201':
|
||||
description: 创建成功
|
||||
@ -158,11 +163,17 @@ paths:
|
||||
parameters:
|
||||
- name: op
|
||||
in: query
|
||||
description: 操作模式
|
||||
description: |
|
||||
更新操作模式:
|
||||
- move: 移动文件或目录到新位置
|
||||
- rename: 重命名文件或目录
|
||||
- change: 修改文件内容或目录属性
|
||||
- copy: 复制文件或目录到新位置
|
||||
required: true
|
||||
schema:
|
||||
type: string
|
||||
enum: [move, rename, change, copy]
|
||||
example: "rename"
|
||||
requestBody:
|
||||
required: true
|
||||
content:
|
||||
@ -197,6 +208,19 @@ paths:
|
||||
description: 删除指定路径的文件或目录
|
||||
operationId: deleteVFSNode
|
||||
tags: [vfs]
|
||||
parameters:
|
||||
- name: op
|
||||
in: query
|
||||
description: |
|
||||
删除操作模式:
|
||||
- recursive: 递归删除目录及其所有内容
|
||||
- force: 强制删除,忽略只读等保护属性
|
||||
不指定时执行普通删除操作
|
||||
required: false
|
||||
schema:
|
||||
type: string
|
||||
enum: [recursive, force]
|
||||
example: "recursive"
|
||||
responses:
|
||||
'204':
|
||||
description: 删除成功
|
||||
@ -307,11 +331,10 @@ components:
|
||||
$ref: '#/components/schemas/VFSNodeType'
|
||||
permissions:
|
||||
type: string
|
||||
description: 权限信息,如 "rw"
|
||||
description: 权限信息,如 "rwo" (读 写 拥有)
|
||||
required:
|
||||
- name
|
||||
- type
|
||||
- modified
|
||||
|
||||
Error:
|
||||
type: object
|
||||
@ -349,4 +372,4 @@ components:
|
||||
example: "传递的第一个参数错误"
|
||||
required:
|
||||
- errtype
|
||||
- message
|
||||
- message
|
||||
|
Reference in New Issue
Block a user