说明
当前接口使用前请使用资源池概况信息查询接口查询带对接的资源池信息,如资源池信息"regionVersion": "v4.0",即可使用;如资源池信息"regionVersion": "v3.0", 不可使用。
接口功能介绍
查询某个region下的快照总量。
URI
GET /v4/ebs_snapshot/query_size-ebs-snap
请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池ID例:100054c0416811e9a6690242ac110002 | 参考请求示例 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败/处理中) | 参考响应示例 | |
message | String | 失败时的错误描述,一般为英文描述 | 参考响应示例 | |
description | String | 失败时的错误描述,一般为中文描述 | 参考响应示例 | |
details | String | 可忽略 | 参考响应示例 | |
returnObj | Object | returnObj | 参考响应示例 | returnObj |
errorCode | String | 业务细分码,为product.module.code三段式码.参考通用结果码 | 参考响应示例 |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
snapshotTotalSize | Integer | region下的所有云硬盘快照的使用量,单位B | 参考响应示例 | |
snapshotTotalCount | Integer | 云硬盘快照数量 | 参考响应示例 | |
azDisplayName | String | az展示名称 | 参考响应示例 | |
details | Array of Object | 不同类型的快照占用的使用量详情 | 参考响应示例 | details |
表 details
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
volumeType | String | 云硬盘类型,SATA/SAS/SSD-genric/SSD/FAST-SSD | 参考响应示例 | |
snapshotSize | Integer | 单个类型的云硬盘的快照使用量,单位为字节 | 参考响应示例 |
请求示例
请求头header
{
}
请求体body
{
"regionID":"fc862f71-d629-4a0e-9fe0-b104963b3f05"
}
响应示例
{
"statusCode": 800,
"message": "SUCCESS",
"description": "成功",
"details":"",
"returnObj": {
"snapshotTotalSize": 1024,
"snapshotTotalCount": 2,
"details": [{
"volumeType":"SATA",
"snapshotSize": 1024}],
"azDisplayName": ""
}
}
状态码
状态码 | 描述 |
---|---|
800 | 表示请求成功。 |
错误码
请参考通用结果码。