查询指定标签的并行文件列表
更新时间 2025-12-10 16:09:37
最近更新时间: 2025-12-10 16:09:37
接口功能介绍
资源池 ID 下,根据标签key、value查询并行文件列表
接口约束
无
URI
POST /v4/hpfs/list-sfs-by-label
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池 ID | 81f7728662dd11ec810800155d307d5b | |
| labelList | 是 | Array of Objects | 待查询的并行文件标签列表 | labelList | |
| pageSize | 否 | Integer | 每页包含的元素个数范围(1-50),默认值为10 | 10 | |
| pageNo | 否 | Integer | 列表的分页页码,默认值为1 | 1 | |
| 表 labelList |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| key | 是 | String | 标签键,长度不能超过128个字符,首尾不能为空字符 | hello | |
| value | 是 | String | 标签值,长度不能超过128个字符,首尾不能为空字符 | world |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800 为成功,900 为失败) | 800 | |
| message | String | 响应描述 | SUCCESS | |
| description | String | 响应描述 | 成功 | |
| returnObj | Object | 返回对象 | returnObj | |
| errorCode | String | 业务细分码,为 product.module.code 三段式码 | sfs.parameter.sfsProtocol | |
| error | String | 业务细分码,为product.module.code三段式大驼峰码 | Sfs.Parameter.SfsProtocol | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| list | Array of Objects | 返回的文件列表 | list | |
| totalCount | Integer | 资源池指定条件下用户并行文件总数 | 10 | |
| currentCount | Integer | 当前页码下查询回来的用户并行文件数 | 10 | |
| total | Integer | 资源池指定条件下用户并行文件总数 | 10 | |
| pageSize | Integer | 每页包含的元素个数范围(1-50) | 10 | |
| pageNo | Integer | 列表的分页页码 | 1 | |
| 表 list |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| sfsName | String | 并行文件名称 | hpfs-2023-0711-16092 | |
| sfsUID | String | 并行文件唯一 ID | 73725123-0de1-5424-8115-7da2a24f3dfb | |
| sfsSize | Integer | 大小(GB) | 512 | |
| sfsType | String | 类型,hpfs_perf(HPC性能型) | hpfs_perf | |
| sfsProtocol | String | 挂载协议,nfs/hpfs | hpfs | |
| sfsStatus | String | 并行文件状态 | available | |
| usedSize | Integer | 已用大小(MB) | 0 | |
| createTime | Long | 创建时刻,epoch 时戳,精度毫秒 | 1692259481000 | |
| updateTime | Long | 更新时刻,epoch 时戳,精度毫秒 | 1692261175000 | |
| expireTime | Long | 过期时刻,epoch 时戳,精度毫秒 | 32503737600000 | |
| projectID | String | 资源所属企业项目 ID | 0 | |
| isEncrypt | Boolean | 是否加密盘 | false | |
| kmsUUID | String | 加密盘密钥 UUID | ||
| onDemand | Boolean | 是否按需订购 | true | |
| regionID | String | 资源池 ID | 81f7728662dd11ec810800155d307d5b | |
| azName | String | 多可用区下的可用区名字 | az2 | |
| clusterName | String | 集群名称 | nm0001 | |
| baseline | String | 性能基线(MB/s/TB) | 200 | |
| sharePath | String | Linux 主机共享路径 | 10.24.177.155:/mnt/hpfs_perf/vh4d6j1eam91va3y/24fcf5e9934f83db1220ee1043c936f6_xvghioi7uyokwk3d | |
| sharePathV6 | String | Linux 主机 IPv6 共享路径 | [100:2::6456:103]:/mnt/hpfs_perf/24fcf5e9934f83db1220ee1043c936f6_xvghioi7uyokwk3d | |
| windowsSharePath | String | Windows 主机共享路径 | ||
| windowsSharePathV6 | String | Windows 主机 IPv6 共享路径 | ||
| mountCount | Integer | 挂载点数量 | 0 | |
| cephID | String | ceph底层id | xvghioi7uyokwk3d | |
| hpfsSharePath | String | HPFS文件系统共享路径(Linux) | 100.125.41.103@o2ib:100.125.41.104@o2ib:/nm0001/24fcf5e9934f83db1220ee1043c936f6_xvghioi7uyokwk3d | |
| hpfsSharePathV6 | String | HPFS文件系统 IPv6共享路径(Linux) | ||
| secretKey | String | HPC型挂载需要的密钥 | 1e2G7Bc1pu4nKInY1834gH1adhghzIGqO92gqxvMXe | |
| dataflowList | Array of Strings | HPFS文件系统下的数据流动策略ID列表 | ["dataflow-j276xd", "dataflow-k97hxd"] | |
| dataflowCount | Integer | HPFS文件系统下的数据流动策略数量 | 2 |
枚举参数
无
请求示例
请求url
https://hpfs-global.ctapi.ctyun.cn/v4/hpfs/list-sfs-by-label
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"sfsUID":"0b55feb9-1331-5934-bf66-9155b7371731",
"labelList":
[
{
"key":"hezzzzzz",
"value":"llllll"
},
{
"key":"test_key2",
"value":"test_value2"
}
]
}
响应示例
{
"returnObj": {
"currentCount": 1,
"totalCount": 1,
"total": 1,
"list": [
{
"updateTime": 1692262640000,
"projectID": "0",
"usedSize": 0,
"kmsUUID": "",
"isEncrypt": false,
"sfsSize": 512,
"onDemand": true,
"regionID": "81f7728662dd11ec810800155d307d5b",
"createTime": 1692259481000,
"sharePath": "",
"mountCount": 0,
"sfsType": "hpfs_perf",
"windowsSharePath": "",
"windowsSharePathV6": "",
"hpfsSharePath": "100.125.41.103@o2ib:100.125.41.104@o2ib:/nm0001/24fcf5e9934f83db1220ee1043c936f6_xvghioi7uyokwk3d",
"hpfsSharePathV6": "",
"secretKey": "1e2G7Bc1pu4nKInY1834gH1adhghzIGqO92gqxvMXe",
"expireTime": 32503737600000,
"sfsProtocol": "hpfs",
"azName": "az2",
"clusterName": "nm0001",
"baseline": "200",
"cephID": "xvghioi7uyokwk3d",
"sfsUID": "a2d4b927-9511-5a9b-b1de-cfe55779c1ea",
"sharePathV6": "",
"sfsStatus": "available",
"sfsName": "hpfs-2023-0711-16092",
"dataflowList": ["dataflow-j276xd", "dataflow-k97hxd"],
"dataflowCount": 2
}
],
"pageSize": 10,
"pageNo": 1
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码