查询指定并行文件绑定的标签
更新时间 2025-12-10 16:09:27
最近更新时间: 2025-12-10 16:09:27
接口功能介绍
无
接口约束
无
URI
GET /v4/hpfs/list-label-by-sfs
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| sfsUID | 是 | String | 并行文件唯一ID | a9c7a4d6-515f-5b98-986c-c1405956957c | |
| regionID | 是 | String | 资源池ID | 332232eb-63aa-465e-9028-52e5123866f0 | |
| pageSize | 否 | Integer | 每页包含的元素个数范围(1-50)，默认值为10 | 10 | |
| pageNo | 否 | Integer | 列表的分页页码，默认值为1 | 1 |
请求参数
请求头header参数 无
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败) | 800 | |
| message | String | 响应描述，一般为英文描述 | SUCCESS | |
| description | String | 响应描述，一般为中文描述 | 成功 | |
| returnObj | Object | 返回结果 | returnObj | |
| errorCode | String | 业务细分码，为 product.module.code 三段式码 | sfs.parameter.labelList | |
| error | String | 业务细分码，为product.module.code三段式大驼峰码 | Sfs.Parameter.LabelList | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| labelList | Array of Objects | 文件系统绑定的标签集合 | list | |
| totalCount | Integer | 指定并行文件绑定的标签总数 | 5 | |
| currentCount | Integer | 当前页码的元素个数 | 5 | |
| pageSize | Integer | 每页个数 | 10 | |
| pageNo | Integer | 当前页数 | 1 | |
| 表 list |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| key | String | 标签键 | key1 | |
| value | String | 标签值 | value1 |
枚举参数
无
请求示例
请求url
https://hpfs-global.ctapi.ctyun.cn/v4/hpfs/list-label-by-sfs?regionID=81f7728662dd11ec810800155d307d5b&sfsUID=a9c7a4d6-515f-5b98-986c-c1405956957c
请求头header
无
请求体body
无
响应示例
{
"returnObj": {
"totalCount": 5,
"currentCount": 5,
"pageNo": 1,
"pageSize": 10,
"labelList": [
{
"value": "test_value",
"key": "test_key"
},
{
"value": "test_value",
"key": "NOT_EIXTS_test_key"
},
{
"value": "world",
"key": "hello"
},
{
"value": "world",
"key": "hi2222"
},
{
"value": "world",
"key": "newhi2222"
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
