对文件添加自定义标签。
接口说明
此接口为增量更新操作：
-
若此次请求中存在同名标签则会覆盖之前的值
-
若标签不存在则新增
-
历史非同名标签不受影响。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/file/put_usertags HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体参数。 |
|
| drive_id |
string |
是 |
空间 id |
1 |
| file_id |
string |
是 |
文件 id |
9520943DC264 |
| user_tags |
array<object> |
是 |
待添加的标签列表。 数组不能为空，且数量上限为 1000。 数组中不能存在同名标签。 |
|
|
object |
是 |
标签名和标签值的长度之和不能超过 2000 字节。 |
||
| key |
string |
是 |
标签名。 不能为空，且不能含有 # 字符。 |
tag |
| value |
string |
否 |
标签值。 不能含有 # 字符。 |
value |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| file_id |
string |
文件 id |
9520943DC264 |
示例
正常返回示例
JSON格式
{
"file_id": "9520943DC264"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。