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