并行文件绑定解绑标签
更新时间 2025-12-10 16:09:18
最近更新时间: 2025-12-10 16:09:18
接口功能介绍
为指定并行文件实例添加标签，支持添加单个和多个标签。
接口约束
- 只能为已创建的文件系统绑定标签，刚创建的文件系统需要等待1-2分钟后才能绑定标签。
- 每个资源下的标签键是唯一的，不可绑定相同标签键。 如果尝试添加已有标签键，则对应的标签值会更新为新值。 例如：某资源先绑定了 city:shanghai，后续如果绑定city:newyork，则city:shanghai自动被解绑；修改标签键等同于解绑旧标签键值的同时绑定新标签键。
- 当输入的是当前账号下不存在的标签时，将创建新的标签并为实例绑定。
- 在一次请求中，不允许出现相同的key
URI
POST /v4/hpfs/update-label
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| sfsUID | 是 | String | 并行文件唯一ID | 0b55feb9-1331-5934-bf66-9155b7371731 | |
| regionID | 是 | String | 资源池ID | 332232eb-63aa-465e-9028-52e5123866f0 | |
| labelList | 是 | Array of Objects | 标签和相应的操作类型 | LabelList | |
| 表 LabelList |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| key | 是 | String | 标签键，长度不能超过128个字符，首尾不能为空字符 | hello | |
| value | 是 | String | 标签值，长度不能超过128个字符，首尾不能为空字符 | world | |
| operateType | 是 | String | 操作类型 绑定 BIND/ 解绑 UNBIND | BIND |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败) | 800 | |
| message | String | 响应描述，一般为英文描述 | SUCCESS | |
| description | String | 响应描述，一般为中文描述 | 成功 | |
| errorCode | String | 业务细分码，为 product.module.code 三段式码 | sfs.sfsInfo.accessFailed | |
| error | String | 业务细分码，为product.module.code三段式码大驼峰码 | Sfs.SfsInfo.AccessFailed |
枚举参数
无
请求示例
请求url
https://hpfs-global.ctapi.ctyun.cn/v4/hpfs/update-label
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"sfsUID":"0b55feb9-1331-5934-bf66-9155b7371731",
"labelList":
[
{
"key":"hezzzzzz",
"value":"llllll",
"operateType":"BIND"
},
{
"key":"test_key2",
"value":"test_value2",
"operateType":"UNBIND"
}
]
}
响应示例
{
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
