文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 文件管理/ 增加文件自定义标签 - addTag
更新时间：2026-04-16 GMT+08:00
查看PDF
分享

增加文件自定义标签 - addTag

功能介绍

增加文件自定义标签，覆盖已存在的同名tag

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/files/tag/{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表示美式英语，不传默认美式英语

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

x-hw-share-folder-id

否

String

参数解释：

共享文件夹ID。如果传入了该请求头，则说明当前的操作是在共享文件夹内。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表3 请求Body参数

参数

是否必选

参数类型

描述

containerId

是

String

参数解释：

空间标识

约束限制：

长度限制64

取值范围：

不涉及

默认取值：

不涉及

tagList

是

Array of TagInfo objects

参数解释：

tag列表

约束限制：

列表长度<100

取值范围：

不涉及

默认取值：

不涉及
表4 TagInfo

参数

是否必选

参数类型

描述

key

是

String

参数解释：

标签名称

约束限制：

字母数字下划线，最大长度128

取值范围：

不涉及

默认取值：

不涉及

value

否

String

参数解释：

标签值

约束限制：

不包含#，最大长度1024

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

code

String

返回码

msg

String

返回消息

请求示例

将空间标识为IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4 空间下，文件id为FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y的文件添加自定义标签tag1和tag2”。

POST /koodrive/ose/v1/files/tag/FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y

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

{
    "containerId": "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4",
     "tagList": [{"tag1":"1","tag2":"2"}]
}

响应示例

状态码：200

返回的信息

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

状态码

状态码

描述

200

返回的信息
父主题： 文件管理