千问办公企业旗舰版开发者文档:修改文件名称或元数据。
认证方式见APP开发者文档 → 认证接入。
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
path 使用 query 编码的绝对逻辑路径;修改/删除不改变当前用户的资源归属。
按 ID 定位后,文件或父目录重命名不改变该 ID。删除后同路径重建会得到新 ID。
200 返回裸 JSON 对象。
401 表示认证失败,403 表示资源权限拒绝;400/422 表示参数无效,404 表示当前用户资源不存在,409 表示冲突。依赖故障保持原错误,不伪造成功;503 为维护或依赖不可用,504 为请求超时。写操作结果未知时先查询资源状态,不盲目重复执行。
- 模块:文件
- 接口:PATCH
/api/openapi/app/v1/drive/files - operationId:
app-patch-files
接口说明
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
path 使用 query 编码的绝对逻辑路径;修改/删除不改变当前用户的资源归属。
按 ID 定位后,文件或父目录重命名不改变该 ID。删除后同路径重建会得到新 ID。
请求参数
| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| path | query | string | 二选一 | 当前用户绝对逻辑路径,使用 query 编码 |
| file_id | query | string (uuid) | 二选一 | 单个非零 UUID,与 path 不能同时传;其他用户 ID 返回 404 |
| filename | body | string | ID 模式必填 | 新名称;路径模式保持可选 |
| metadata | body | object | 否 | 仅路径模式;ID 模式只接收 filename,原元数据保留 |
响应
200 返回裸 JSON 对象。
响应字段
| 字段 | 类型 | 必返 | 约束 | 说明 |
|---|---|---|---|---|
| created_at | string | 是 | date-time | 创建时间,RFC 3339。 |
| display_name | string | 否 | — | 服务端提供的展示名称,可能省略。 |
| file_id | string | 是 | uuid | 当前用户网盘中的稳定文件/目录 UUID;重命名不改变,复制生成新 ID。 |
| is_directory | boolean | 是 | — | 是否为目录。 |
| metadata | object<string, string> | 是 | — | 字符串键值元数据;无元数据时为 {}。 |
| mime_type | string | 是 | — | MIME 类型;目录为 application/x-directory。 |
| moderation_state | string | 否 | — | 文件审核状态;未提供时不应推断审核已通过。 |
| modified_at | string | 是 | date-time | 最后修改时间,RFC 3339。 |
| path | string | 是 | — | 当前用户可见的绝对逻辑路径。 |
| presigned_url | string | 否 | — | 临时访问 URL,可能省略;原样使用,不附带登录凭据。 |
| size | integer | 是 | int64 | 大小,单位字节;目录按服务端累计大小返回。 |
| source | string | 是 | — | 服务端记录的文件来源,不由客户端据此判断权限。 |
| storage_path | string | 否 | — | 带隔离前缀的逻辑存储路径,不是 OSS 对象 key;仅部分响应提供。 |