查询存储库列表
更新时间 2026-04-02 15:48:53
最近更新时间: 2026-04-02 15:48:53
接口功能介绍
获取该用户所有存储库列表
接口约束
1、根据用户输入的存储库Name，查询该存储库信息。如不指定，则获取该用户所有存储库信息列表
URI
GET /v4/backup/query-storage-backup
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 参考请求示例 | |
| backupStorageID | 否 | String | 存储库ID，如不指定，查询用户资源池下所有存储库列表 | 参考请求示例 | |
| queryContent | 否 | String | 模糊查询：存储库名称 | test-storage | |
| backupStorageStatus | 否 | String | 状态查询: Available-可用/Expire-已到期/Refing-退订中/Destorying-销毁中 | Available |
请求参数
请求头header参数 无
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败) | 800 | |
| message | String | 失败时的错误描述，一般为英文描述 | SUCCESS | |
| description | String | 失败时的错误描述，一般为中文描述 | 成功 | |
| returnObj | Object | 成功时返回对象 | returnObj | |
| errorCode | String | 业务细分码，为product.module.code三段式码。 | backup.regionInfo.empty | |
| error | String | 业务细分码，为product.module.code三段式大驼峰码 | Backup.RegionInfo.Empty |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| backupStorageCount | Integer | 存储库的数量 | 10 | |
| backupStorageList | Array of Objects | 存储库的详情列表 | backupStorageList |
表 backupStorageList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| backupStorageID | String | 存储库ID | 参考响应示例 | |
| backupStorageName | String | 存储库名称 | 参考响应示例 | |
| backupStorageCapacity | String | 存储库容量 | 参考响应示例 | |
| backupStorageFreeCapacity | String | 存储库剩余容量 | 参考响应示例 | |
| backupStorageStatusDesc | String | 存储库状态描述 | 参考响应示例 | |
| backupStorageCreatTime | String | 存储库创建时间 | 参考响应示例 | |
| backupStorageExpireTime | String | 存储库到期时间 | 参考响应示例 | |
| regionName | String | 地域名称 | 参考响应示例 | |
| backupStorageStatusCode | String | 存储库状态码 | 参考响应示例 | |
| multiAz | String | 是否支持跨可用区备份 | 参考响应示例 |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"backupStorageID": "73f321ea-62ff-11ec-a8bc-005056898fe0"
}
响应示例
{
"httpstatus": 200,
"httpresult": {
"returnObj": {
"backupStorageList": [
{
"backupStorageExpireTime": "2026-03-16 16:49:39",
"backupStorageStatusCode": "Available",
"multiAz": "单az",
"backupStorageCreatTime": "2026-01-16 16:49:38",
"backupStorageCapacity": "112 G",
"backupStorageName": "backupStorageName-ZDMus",
"backupStorageFreeCapacity": "112.00",
"regionName": "4.0实验局",
"backupStorageID": "ec112d1f-3b2f-4503-a903-19b6c3e5c63f",
"backupStorageStatusDesc": "可用"
}
],
"backupStorageCount": 1
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
}
状态码
请参考 状态码
错误码
请参考 错误码
