接口功能介绍
查询云硬盘备份存储库列表。
当前页面接口为旧版 API，未来根据实际使用情况可能退役，推荐使用新版本接口，新版本接口更加规范，覆盖场景更全。
接口约束
无
URI
GET /v4/ebs-backup/repo/list
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
| repositoryName | 否 | String | 云硬盘备份存储库名称 | test-repo | |
| repositoryID | 否 | String | 云硬盘备份存储库ID | 9915c3f4-8d78-445a-a1da-d8d9287d506b | |
| status | 否 | String | 云硬盘备份存储库状态，active-可用，creating-创建中，error-失败，freezing-冻结，expired-已过期 | active | |
| hideExpire | 否 | Boolean | 是否隐藏过期的云硬盘备份存储库 | true | |
| queryContent | 否 | String | 目前，仅支持 备份存储库名称的过滤 | repo | |
| pageNo | 否 | Integer | 页码，默认1 | 1 | |
| pageSize | 否 | Integer | 每页记录数目 ,默认10 | 10 | |
| asc | 否 | Boolean | 和sort配合使用，是否升序排列 | true | |
| sort | 否 | String | 和asc配合使用，指定用于排序的字段。可选字段：createdDate/expiredDate/size/freeSize/usedSize/name | createdDate | |
| projectID | 否 | String | 企业项目ID，默认“0” | 0 |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
| 参数 | 是否必填 | 类型 | 描述 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 返回状态码（800为成功，900为失败） | 800 | |
| message | 是 | String | 错误信息的英文描述 | SUCCESS | |
| description | 是 | String | 错误信息的本地化描述（中文） | 成功 | |
| returnObj | 否 | Object | 成功时返回对象 | returnObj | |
| errorCode | 否 | String | 业务错误细分码，发生错误时返回 | 参考错误码 |
表 returnObj
| 参数名 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| repositoryList | 是 | Array | 云硬盘备份存储库列表 | repositoryList | |
| totalCount | 是 | Integer | 云硬盘备份存储库总数 | 11 | |
| currentCount | 是 | Integer | 当前页云硬盘备份存储库数 | 10 |
表 repositoryList
| 参数名 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
| repositoryID | 是 | String | 备份存储库ID | 9915c3f4-8d78-445a-a1da-d8d9287d506b | |
| repositoryName | 是 | String | 备份存储库名称 | test-repo | |
| status | 是 | String | 云硬盘备份存储库状态，active-可用，creating-创建中，error-失败，freezing-冻结，expired-已过期 | active | |
| size | 是 | Integer | 云硬盘备份存储库总容量，单位GB | 100 | |
| freeSize | 是 | Integer | 云硬盘备份存储库剩余大小，单位GB | 90 | |
| usedSize | 是 | Integer | 云硬盘备份存储库使用大小，单位Byte | 10240000000 | |
| createdDate | 是 | Integer | 创建时间 | 663136607 | |
| updatedDate | 是 | Integer | 更新时间 | 663136607 | |
| expiredDate | 是 | Integer | 到期时间 | 663136607 | |
| expired | 是 | Boolean | 备份存储库是否到期 | false | |
| freeze | 是 | Boolean | 是否冻结 | false | |
| customerID | 是 | String | 用户ID | 59093d15-8a3c-53b9-b61b-484af10a3e97 | |
| azName | 是 | String | 可用域 | null | |
| paas | 是 | Boolean | 是否支持PAAS | false | |
| backupList | 是 | array | 备份存储库下的可用的备份列表，元素为备份ID | ["59093d15-8a3c-53b9-b61b-484af10a3e97","59093d15-8a3c-53b9-b61b-484af10a3e98"] | |
| paymentType | 是 | String | 付费方式 | null | |
| projectID | 是 | String | 企业项目ID | 0 |
请求示例
请求头header
无
请求体body
无
响应示例
{
"returnObj":
{
"totalCount": 6,
"currentCount": 1,
"repositoryList": [{
"status": "active",
"paas": false,
"expiredDate": 1678927767,
"paymentType": null,
"regionID": "81f7728662dd11ec810800155d307d5b",
"usedSize": 0,
"repositoryID": "9badc8dd-8dff-4acb-8bf4-4c0f99e89118",
"freeze": false,
"updatedDate": 1676508582,
"azName": null,
"createdDate": 1676508551,
"backupList": [],
"customerID": "84e0ef66-b86d-5927-b144-95f47f63a91f",
"repositoryName": "yue20230216test04",
"expired": false,
"freeSize": 120,
"size": 120,
"projectID": "0"
}]},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
错误码
| errorCode | 描述 |
|---|---|
| EbsBackup.RegionInfo.Empty | 查询资源池信息为空或资源池不存在，请确认资源池ID是否有效 |
| EbsBackup.RegionInfo.AccessFailed | 查询资源池失败，请重试。如果多次尝试失败，请提交工单 |
| EbsBackup.RegionInfo.DataDamaged | 查询资源池信息不符预期，请重试。如果多次尝试失败，请提交工单 |
| EbsBackup.RepositoryInfo.AccessFailed | 查询云硬盘备份存储库失败 |
| EbsBackup.RepositoryInfo.DataDamaged | 云硬盘备份存储库数据不符合预期 |
| EbsBackup.Parameter.InvalidPageParams | 请求参数错误：{错误原因} |
| EbsBackup.Parameter.InvalidRegionID | 请求参数错误：{错误原因} |
| EbsBackup.OrderCheck.InvalidProjectID | 企业项目不存在，请确认企业项目ID是否有效 |
