- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 快速入门
- API
-
历史API
- API
-
Cinder API
-
云硬盘管理
- 查询单个云硬盘详情(废弃)
- 创建云硬盘(废弃)
- 创建云硬盘
- 查询所有云硬盘详情
- 删除云硬盘(废弃
- 删除云硬盘
- 更新云硬盘(废弃)
- 更新云硬盘
- 查询云硬盘类型列表(废弃)
- 查询云硬盘类型列表
- 查询单个云硬盘类型的详情(废弃)
- 查询单个云硬盘类型的详细信息
- 查询云硬盘列表(已废弃)
- 查询云硬盘列表
- 查询单个云硬盘详情(废弃)
- 查询单个云硬盘详情
- 查询所有云硬盘详情(废弃)
- 查询扩展接口(废弃)
- 查询扩展接口(废弃)
- 扩容云硬盘
- 扩容云硬盘(废弃)
- 设置云硬盘启动盘标识
- 将云硬盘导出为镜像
- 设置云硬盘启动盘标识(废弃)
- 设置云硬盘只读标识
- 设置云硬盘只读标识(废弃)
- 将云硬盘导出为镜像(废弃)
- 挂载云硬盘(废弃)
- 卸载云硬盘(废弃)
- 保留云硬盘(废弃)
- 取消保留云硬盘(废弃)
- 快照管理
- 配额管理
- 云硬盘过户管理
- 云硬盘元数据管理
- 快照元数据管理
- API版本查询
- 可用区查询
-
云硬盘管理
- 权限和授权项
- 附录
- 修订记录
- SDK参考
- 场景代码示例
-
常见问题
- 常见问题汇总
- 云硬盘通用问题
- 云硬盘计费问题
-
云硬盘挂载问题
- 为什么登录到云服务器后看不到已挂载的数据盘
- 云硬盘不支持挂载至云服务器怎么办
- 一块云硬盘可以挂载到多台云服务器上吗
- 云硬盘可以挂载至不同可用区的云服务器吗
- 怎样为云服务器增加数据盘(例如D盘或者dev/vdb1)
- 包年/包月云硬盘可以挂载给其他云服务器吗
- 不同类型的磁盘可以挂载在同一个云服务器上吗
- 系统盘和数据盘之间可以随意转换吗
- Linux系统的云硬盘挂载至Windows系统后需如何处理
- 随包周期云服务器购买的云硬盘,可以挂载至其它包周期云服务器吗
- 随云服务器购买的系统盘或数据盘可以换挂载点吗
- 控制台与弹性云服务器内部之间磁盘挂载点的对应关系
- 云硬盘挂载的包年/包月云服务器已到期,如何查看盘内数据
- 云硬盘扩容问题
- 云硬盘卸载问题
- 云硬盘删除问题
- 云硬盘容量问题
- 云硬盘快照问题
- 云硬盘性能问题
- 共享云硬盘问题
- 云硬盘备份问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
创建云硬盘(废弃)
功能介绍
创建一个或多个云硬盘。由于兼容性原因导致存在该接口,目前已经废弃。请使用性能更佳的接口。
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/cloudvolumes
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目 ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
volume |
是 |
CreateDiskOption object |
待创建的云硬盘信息。 |
OS-SCH-HNT:scheduler_hints |
否 |
CreateVolumeSchedulerHints object |
云硬盘调度参数,可用于指定云硬盘创建到某个专属存储池中 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
availability_zone |
是 |
String |
指定要创建云硬盘的可用区。 |
backup_id |
否 |
String |
备份ID,从备份创建云硬盘时为必选。 |
count |
否 |
Integer |
批量创云硬盘的个数。如果无该参数,表明只创建1个云硬盘,目前最多支持批量创建100个。 从备份创建云硬盘时,不支持批量创建,数量只能为“1”。 如果发送请求时,将参数值设置为小数,则默认取小数点前的整数。 |
description |
否 |
String |
云硬盘的描述。最大支持85个字符。 |
enterprise_project_id |
否 |
String |
企业项目ID。创建云硬盘时,给云硬盘绑定企业项目ID。 |
imageRef |
否 |
String |
镜像ID,指定该参数表示创建云硬盘方式为从镜像创建云硬盘。 |
metadata |
否 |
Map<String,String> |
创建云硬盘的metadata信息 可选参数如下:[__system__cmkid] metadata中的加密cmkid字段,与__system__encrypted配合表示需要加密,cmkid长度固定为36个字节。
说明:
请求获取密钥ID的方法请参考:"查询密钥列表"。 [__system__encrypted] metadata中的表示加密功能的字段,0代表不加密,1代表加密。不指定该字段时,云硬盘的加密属性与数据源保持一致,如果不是从数据源创建的场景,则默认不加密。 [full_clone] 从快照创建云硬盘时,如需使用link克隆方式,请指定该字段的值为0。 [hw:passthrough]
|
multiattach |
否 |
Boolean |
是否为共享云硬盘。true为共享盘,false为普通云硬盘。 |
name |
否 |
String |
云硬盘名称。 如果为创建单个云硬盘,name为云硬盘名称。最大支持64个字符。 创建的云硬盘数量(count字段对应的值)大于1时,为区分不同云硬盘,创建过程中系统会自动在名称后加“-0000”的类似标记。例如:volume-0001、volume-0002。最大支持64个字符。 |
shareable |
否 |
String |
是否为共享云硬盘。true为共享盘,false为普通云硬盘。\n 该字段已经废弃,请使用multiattach。 |
size |
是 |
Integer |
云硬盘大小,单位为GiB,其限制如下:
|
snapshot_id |
否 |
String |
快照ID,指定该参数表示创建云硬盘方式为从快照创建云硬盘。 |
volume_type |
是 |
String |
云硬盘类型。 目前支持"SATA","SAS","GPSSD","SSD","ESSD","GPSSD2","ESSD2"七种。
当指定的云硬盘类型在availability_zone内不存在时,则创建云硬盘失败。
说明:
从快照创建云硬盘时,volume_type字段必须和快照源云硬盘保持一致。 了解不同云硬盘类型的详细信息,请参见云硬盘类型及性能介绍。 |
tags |
否 |
Map<String,String> |
云硬盘标签信息。 |
响应参数
状态码: 202
参数 |
参数类型 |
描述 |
---|---|---|
job_id |
String |
任务ID,云硬盘为按需计费时返回该参数。 通过JobId查询云硬盘创建任务是否完成查询job的状态。 |
volume_ids |
Array of strings |
待创建的云硬盘ID列表。
说明:
通过云硬盘ID查询云硬盘详情 ,若返回404 可能云硬盘正在创建中或者已经创建失败。 通过JobId查询云硬盘创建任务是否完成查询job的状态。 |
状态码: 400
请求示例
{ "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 |
错误码
请参见错误码。