批量创建云磁盘
更新时间：2023-08-09
接口描述
本接口用于批量创建云磁盘。
请求结构
POST /v2/volume HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"billing": "Postpaid",
"cdsSizeInGB": 0,
"deployInstances": [
{
"purchaseCount": 0,
"regionId": ""
}
],
"description": "",
"name": "",
"snapShotId": "",
"storageType": "ssd"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
|---|---|---|---|---|
| createCdsRequest | 创建云磁盘的请求 | body | 是 | CreateCdsRequest |
| billing | 订单、计费相关参数 | 否 | string | |
| cdsSizeInGB | CDS磁盘容量，必须为大于0的整数，单位为GB，云磁盘的起售容量不小于50GB | 是 | integer | |
| deployInstances | 所属节点 | 是 | List<DeployInstance> | |
| purchaseCount | 购买数量 | 是 | integer | |
| regionId | 节点ID | 是 | string | |
| description | 磁盘的描述信息 | 否 | string | |
| name | 磁盘的名称。支持大小写字母、数字、中文以及-_ /.特殊字符，必须以字母开头，长度1-65 | 是 | string | |
| snapShotId | 快照ID，支持从快照创建磁盘。当此参数存在时且不为空时，cdsSizeInGB参数将被忽略， 此时非必需 |
否 | string | |
| storageType | 云磁盘类型。包括ssd（通用型SSD）和hdd (通用型HDD)，默认 ssd | 是 | string | |
| clientToken | 幂等性Token，是一个长度不超过64位的ASCII字符串 | query | 否 | string |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 参数说明 | 类型 |
|---|---|---|
| volumeIds | 磁盘ID列表 | List<String> |
错误码
请参照错误返回章节的内容。
请求示例
POST /v2/volume HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"billing": "Postpaid",
"cdsSizeInGB": 52,
"deployInstances": [
{
"purchaseCount": 1,
"regionId": "cn-haikou-cm"
}
],
"description": "desc0519",
"name": "test_cds_0519",
"snapShotId": "",
"storageType": "ssd"
}响应示例
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
{
"volumeIds": [
"cds-skjerwflxmtu"
]
}