响应示例
6.1.2 创建云硬盘(废弃)
状态码
状态码 描述
202 Accepted 400 Bad Request
错误码
请参见错误码。
6.1.2 创建云硬盘(废弃)
功能介绍
创建一个或多个云硬盘。由于兼容性原因导致存在该接口，目前已经废弃。请使用性 能更佳的接口。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/{project_id}/cloudvolumes
表6-10 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目 ID
请求参数
表6-11 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String Token的有效期为24小时，需要 使用一个Token鉴权时，可以先 缓存起来，避免频繁调用。
表6-12 请求 Body 参数
参数 是否必选 参数类型 描述
volume 是 CreateDiskO
ption object 待创建的云硬盘信息。
表6-13 CreateDiskOption
参数 是否必选 参数类型 描述
availability_zo
ne 是 String 指定要创建云硬盘的可用区。
backup_id 否 String 备份ID，从备份创建云硬盘时为 必选。
count 否 Integer 批量创云硬盘的个数。如果无该
参数，表明只创建1个云硬盘，
目前最多支持批量创建100个。
从备份创建云硬盘时，不支持批 量创建，数量只能为“1”。
如果发送请求时，将参数值设置 为小数，则默认取小数点前的整 数。
description 否 String 云硬盘的描述。最大支持255个 字节。
enterprise_pro
ject_id 否 String 企业项目ID。创建云硬盘时，给
云硬盘绑定企业项目ID。
imageRef 否 String 镜像ID，指定该参数表示创建云
硬盘方式为从镜像创建云硬盘。
参数 是否必选 参数类型 描述 metadata 否 Map<String,St
ring> 创建云硬盘的metadata信息可 选参数如下:metadata中的加密
full_clone: 从快照创建云硬盘 时，如需使用link克隆方式，请 Virtual Block Device)类型，
即为默认类型，VBD只能支 持简单的SCSI读写命令。
● 该字段不存在时，云硬盘默 认为VBD类型。
multiattach 否 Boolean 是否为共享云硬盘。true为共享 盘，false为普通云硬盘。
参数 是否必选 参数类型 描述
shareable 否 String 是否为共享云硬盘。true为共享 盘，false为普通云硬盘。 该字 段已经废弃，请使用
multiattach。
size 是 Integer 云硬盘大小，单位为GB，其限
制如下： 系统盘：
1GB-1024GB 数据盘：
10GB-32768GB 创建空白云硬 盘和从 镜像/快照 创建云硬盘
snapshot_id 否 String 快照ID，指定该参数表示创建云 硬盘方式为从快照创建云硬盘。
volume_type 是 String 云硬盘类型。
目前支持"SATA"，"SAS"，
"GPSSD"和"SSD"四种。
● "SATA"为普通IO云硬盘(已售 罄)
● "SAS"为高IO云硬盘
● "GPSSD"为通用型SSD云硬 盘
● "SSD"为超高IO云硬盘 当指定的云硬盘类型在 tags 否 Map<String,St
ring> 云硬盘标签信息。
响应参数
状态码： 202
表6-14 响应 Body 参数
参数 参数类型 描述
job_id String 正常返回时返回的任务ID。
说明如果需要查询job的状态，请参考查询job的状态。
状态码： 400
表6-15 响应 Body 参数
参数 参数类型 描述
error Error object 出现错误时，返回的错误信息
表6-16 Error
参数 参数类型 描述
code String 出现错误时，返回的错误码。 错误码和其对应的 含义请参考错误码说明。
message String 错误提示信息。
请求示例
{ "volume" : { "backup_id" : null, "count" : 1,
"availability_zone" : "az1.dc1", "description" : "test_volume_1", "size" : 120,
"name" : "test_volume_1", "imageRef" : null, "volume_type" : "SSD", "metadata" : {
"__system__encrypted" : "0", "__system__cmkid" : null }
}}
响应示例
状态码： 202 Accepted
{ "job_id" : "70a599e0-31e7-49b7-b260-868f441e862b"
}
状态码： 400 Bad Request
{ "error" : {
"message" : "XXXX", "code" : "XXX"
}}
状态码
状态码 描述
202 Accepted 400 Bad Request
错误码
请参见错误码。