获取可购买磁盘信息
更新时间：2024-07-02
该接口用于根据可用区获取可购买的磁盘类型、大小、配额限制。
请求结构
GET /v{version}/volume/disk?zoneName={zoneName}&clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| clientToken | String | 是 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见 幂等性。 |
| zoneName | String | 是 | Query参数 | zone信息，zoneName命名规范是“国家-region-可用区序列"，小写，例如北京可用区A为"cn-bj-a"。当传入zoneName为空串或为非法zone时，会返回全部可用区的可购买磁盘信息。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| cdsRatio | String | 单个BCC可创建的最大磁盘数 |
| cdsTotalCapacityGB | String | 磁盘总容量上限（GB） |
| cdsTotal | String | BCC实例个数 * cdsRatio |
| cdsCreated | String | 已创建磁盘个数，包括回收站内的磁盘 |
| cdsUsedCapacityGB | String | 磁盘已使用总容量（GB） |
| diskZoneResources | DiskZoneResources | 可用区可创建的磁盘信息，具体参数可见 DiskZoneResources |
请求示例
GET http://bcc.bj.baidubce.com/v2/volume/disk?zoneName=cn-bj-a&clientToken=3A8d84403************
Host: bcc.bj.baidubce.com
Authorization: authorization-string响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"cdsRatio": "15",
"cdsTotalCapacityGB": "163840",
"cdsTotal": "75",
"cdsCreated": "0",
"cdsUsedCapacityGB": "0",
"diskZoneResources": [
{
"zoneName": "cn-bj-a",
"diskInfos": [
{
"storageType": "premium_ssd",
"maxDiskSize": 32765,
"minDiskSize": 50
},
{
"storageType": "ssd",
"maxDiskSize": 32765,
"minDiskSize": 5
},
{
"storageType": "enhanced_ssd_pl1",
"maxDiskSize": 32765,
"minDiskSize": 5
}
]
}
]
}