文档首页> 云盘服务 KooDrive> API参考> API> 文件管理> 重命名文件
更新时间：2024-01-05 GMT+08:00
查看PDF
分享

重命名文件

功能介绍

重命名文件。

URI

POST /koodrive/ose/v1/files/rename/{fileId}

表1 路径参数

参数

是否必选

参数类型

描述

fileId

是

String

文件ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取

x-trace-id

否

String

业务跟踪id

X-Csrf-Token

是

String

CSRF Token

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语
表3 请求Body参数

参数

是否必选

参数类型

描述

containerId

是

String

空间标识

name

是

String

新文件名，不能包含'<>|:"*？/\'，不能等于..或.

最大长度：80

renameMode

否

Integer

重名策略，枚举值：

  • 2：强制重命名，出现重名文件时，文件名末尾追加时间戳

  • 3：拒绝重命名，出现重名文件时，创建失败

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

code

String

返回码

msg

String

返回消息

请求示例

将IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4空间下，文件id为FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y的文件重命名为“下载”。

POST http://10.34.116.66:8080/koodrive/ose/v1/files/rename/FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y

Authorization:Bearer+10f88d07fa3b86e520ab75eef417574840f15a544791e9ff
X-Csrf-Token:fc41ff2190ff0d6a6a08ed12718274d8f0d9330a8ce439a5

{
    "name": "下载",
    "containerId": "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4",
    "renameMode": 2
}

响应示例

状态码： 200

文件详情

{
  "code" : 0,
  "msg" : "success"
}

状态码

状态码

描述

200

文件详情
父主题： 文件管理
分享：

    相关文档

    相关产品