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

重命名文件

功能介绍

重命名文件。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

fileId

是

String

文件ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

X-Traceid

否

String

消息日志跟踪标识（必须58位）

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 /koodrive/ose/v1/files/rename/FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y

Authorization:Bearer+10f88*********4791e9ff

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

响应示例

状态码： 200

重命名完成返回的信息

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

状态码

状态码

描述

200

重命名完成返回的信息
父主题： 文件管理