接口功能介绍
查询云硬盘备份实际占用存储大小
接口约束
无
URI
GET /v4/ebs-backup/show-usage
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
| backupID | 是 | String | 云硬盘备份ID | 59093d15-8a3c-53b9-b61b-484af10a3e97 |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
| 参数 | 是否必填 | 类型 | 描述 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 返回状态码（800为成功，900为失败） | 800 | |
| message | 是 | String | 错误信息的英文描述 | SUCCESS | |
| description | 是 | String | 错误信息的本地化描述（中文） | 成功 | |
| returnObj | 否 | Object | 成功时返回对象 | returnObj | |
| errorCode | 否 | String | 业务错误细分码，发生错误时返回 | 参考错误码 |
表 returnObj
| 参数名 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| backupSize | 是 | Integer | 云硬盘备份大小，单位Byte | 1024000 |
请求示例
请求头header
无
请求体body
无
响应示例
{
"statusCode": 800,
"message": "SUCCESS",
"description": "成功",
"returnObj": {
"backupSize": 10
}
}
错误码
| errorCode | 描述 |
|---|---|
| EbsBackup.RegionInfo.Empty | 查询资源池信息为空或资源池不存在，请确认资源池ID是否有效 |
| EbsBackup.RegionInfo.AccessFailed | 查询资源池失败，请重试。如果多次尝试失败，请提交工单 |
| EbsBackup.RegionInfo.DataDamaged | 查询资源池信息不符预期，请重试。如果多次尝试失败，请提交工单 |
| EbsBackup.Parameter.InvalidBackupID | 请求参数错误：{错误原因} |
| EbsBackup.Parameter.InvalidRegionID | 请求参数错误：{错误原因} |
| EbsBackup.BackupInfo.NotFound | 云硬盘备份未找到 |
| EbsBackup.BackupInfo.AccessFailed | 查询云硬盘备份失败 |
| EbsBackup.BackupInfo.DataDamaged | 云硬盘备份数据不符合预期 |
