接口功能介绍
查询FILESET详情
接口约束
无
URI
GET /v4/hpfs/info-fileset
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池 ID,例:100054c0416811e9a6690242ac110002 | 81f7728662dd11ec810800155d307d5b | |
| filesetID | 是 | String | FILESET唯一ID | fset-nkh6qmv3iaf |
请求参数
请求头header参数 无
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功,900为处理中/失败,详见errorCode) | 800 | |
| message | String | 响应描述 | SUCCESS | |
| description | String | 响应描述 | 成功 | |
| returnObj | Object | 返回对象 | returnObj | |
| errorCode | String | 业务细分码,为 product.module.code 三段式码 | sfs.fileset.notExists | |
| error | String | 业务细分码,为product.module.code三段式大驼峰码 | Sfs.Fileset.NotExists |
表 returnObj | 参数 | 参数类型 | 说明 | 示例 | 下级对象 | | --------- | ------- | ------- | ------- | ------- | | regionID | String | 资源池id | b73e3ad4-417f-11ed-bad1-525400cc3b79 | | | filesetID | String | FILESET唯一id | fset-nkh6qmv3iaf | | | sfsUID | String | 并行文件唯一id | a2d4b927-9511-5a9b-b1de-cfe55779c1ea | | | filesetStatus | String | FILESET状态:available(可用)、unusable(异常) | available | | | filesetPath | String | FILESET在文件系统中的绝对路径 | /test/aaa/ | | | capacityQuota | Integer | FILESET的容量配额限制,单位GB | 500 | | | fileCountQuota | Long | FILESET数量配额限制 | 2000000 | | | capacityQuotaUsed | Integer | FILESET已使用的容量配额,单位GB,向上取整 | 50 | | | fileCountQuotaUsed | Long | FILESET已使用的数量配额 | 90000 | | | filesetDescription | String | FILESET的描述 | 这是一个fileset | | | createTime | Long | FILESET的创建时间 | 1692259495000 | | | azName | String | 可用区名称 | az1 | |
枚举参数
无
请求示例
请求url
https://hpfs-global.ctapi.ctyun.cn/v4/hpfs/info-fileset?regionID=81f7728662dd11ec810800155d307d5b&filesetID=fset-nkh6qmv3iaf
请求头header
无
请求体body
无
响应示例
{
"returnObj": {
"regionID": "81f7728662dd11ec810800155d307d5b",
"filesetID": "fset-nkh6qmv3iaf",
"sfsUID": "a2d4b927-9511-5a9b-b1de-cfe55779c1ea",
"filesetPath": "/test01/test0/",
"filesetStatus": "available",
"capacityQuota": 500,
"fileCountQuota": 2000000,
"capacityQuotaUsed": 50,
"fileCountQuotaUsed": 90000,
"filesetDescription": "这是一个fileset",
"createTime": 1692259481000,
"azName": "az1"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码