接口介绍
根据资源池 ID 和文件系统name,查询文件系统剩余容量
接口约束
无
URI
GET /v4/sfs/free-storage
路径参数
无
Query 参数
无
请求参数
请求头 header 参数
无
请求体 body 参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
regionID | 是 | String | 资源池 ID | 参考请求示例 |
name | 是 | String | 文件系统名称 | 参考请求示例 |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
statusCode | 是 | Integer | 返回状态码(800为成功,900为失败) | 800 |
message | 否 | String | 失败时的错误描述,一般为英文描述 | 参考结果码 |
description | 否 | String | 失败时的错误描述,一般为中文描述 | 参考结果码 |
returnObj | 是 | Object | 参考returnObj | 参考响应示例 |
errorCode | 否 | String | 业务细分码,为 product.module.code 三段式码 | 参考结果码 |
表returnObj
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
fuid | 是 | String | 文件系统ID | 参考响应示例 |
name | 是 | String | 文件系统名称 | 参考响应示例 |
regionID | 是 | String | 资源池 ID | 参考响应示例 |
freeSize | 是 | String | 文件系统剩余容量 | 参考响应示例 |
请求示例
请求头
无
请求体 body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"name": "sfs-test-02"
}
响应示例
{
"returnObj": {
"regionID": "b73e3ad4-417f-11ed-bad1-525400cc3b79",
"fuid": "487dea6c-938c-5ef4-abae-b8a4d59671d3",
"name": "sfs-test-02",
"freeSize": "512000MB"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
状态码 | 说明 |
---|---|
200 | 表示请求成功 |
错误码
请参考错误码说明