接口功能介绍
天翼云云硬盘快照服务以云硬盘的快照使用总容量为粒度进行统计并计费。您可以查询某个资源池下的快照使用量，快照使用总容量为当前云硬盘中所有快照的数据块所占用的存储空间之和。
接口约束
无
URI
GET /v4/ebs_snapshot/query_size
请求参数
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 参考请求示例 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 返回状态码(800为成功，900为失败) | 参考响应示例 | |
| message | 是 | String | 成功或失败时的描述，一般为英文描述 | 参考响应示例 | |
| description | 是 | String | 成功或失败时的描述，一般为中文描述 | 参考响应示例 | |
| returnObj | 是 | Object | 返回数据结构体 | 参考响应示例 | returnObj |
| errorCode | 是 | String | 业务细分码，为product.module.code三段式码. 参考通用结果码 | 参考响应示例 |
表 returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| totalSize | 是 | Integer | region下的所有云硬盘快照的使用量 | 参考响应示例 | |
| totalCount | 是 | Integer | 云硬盘快照数量 | 参考响应示例 | |
| details | 是 | Array of Object | 不同类型的快照占用的使用量详情 | 参考响应示例 | details |
| az_display_name | 是 | String | 可用区名称 | 参考响应示例 |
表 details
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| volumeType | 是 | String | 云硬盘类型，取值为： ●SATA：普通IO ●SAS：高IO ●SSD：超高IO ●FAST-SSD：极速型SSD ●XSSD-0、XSSD-1、XSSD-2：X系列云硬盘 | 参考响应示例 | |
| size | 是 | Integer | 单个类型的云硬盘的快照使用量,单位为字节 | 参考响应示例 |
请求示例
请求头header
无
请求体body
{
"regionID":"fc862f71-d629-4a0e-9fe0-b104963b3f05"
}响应示例
{
"statusCode": 800,
"message": "SUCCESS",
"description": "成功",
"details": "",
"returnObj": {
"totalSize": 1024,
"totalCount": 2,
"az_display_name": "",
"details": [{
"volumeType":"SATA-public",
"size": 1024}]
}
}状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功 |
错误码
请参考通用结果码。
