获取可购买磁盘信息

该接口用于根据可用区获取可购买的磁盘类型、大小、配额限制。

请求结构

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。注意：该参数已经废弃，即不在按照BCC实例数量限制用户购买的CDS数量，当前返回为固定值
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
                }
            ]
        }
    ]
}