检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询单个云硬盘详情(废弃) 功能介绍 查询单个云硬盘的详细信息。该接口已废弃，请使用性能更佳的接口。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/os-vendor-volumes/{volume_id} 表1 路径参数 参数 是否必选 参数类型
查询所有云硬盘详情(废弃) 功能介绍 分类查询所有云硬盘详情。 注意： 该接口已废弃，请使用性能更佳的接口 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/os-vendor-volumes/detail 表1 路径参数 参数 是否必选 参数类型
删除云硬盘的单个元数据（废弃） 功能介绍 删除云硬盘的单个元数据。 调用方法 请参见如何调用API。 URI DELETE /v2/{project_id}/volumes/{volume_id}/metadata/{key} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
通过标签查询云硬盘资源实例详情 功能介绍 通过标签查询云硬盘资源实例详情。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/cloudvolumes/resource_instances/action 表1 路径参数 参数 是否必选 参数类型
为指定云硬盘批量添加标签。 添加标签时，如果云硬盘的标签已存在相同key，则会覆盖已有标签。 单个云硬盘最多支持创建10个标签。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/cloudvolumes/{volume_id}/tags/action 表1 路径参数
查询云硬盘快照详情列表 功能介绍 查询云硬盘快照详情列表。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/cloudsnapshots/detail 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
附录 错误码 状态码 云硬盘状态 云硬盘快照状态 获取项目ID 获取账号ID
回滚快照到云硬盘(废弃) 功能介绍 将快照数据回滚到云硬盘。该接口已废弃，请使用性能更佳的接口。 接口约束 只支持快照回滚到源云硬盘，不支持快照回滚到其它指定云硬盘。 只有云硬盘状态处于“available”或“error_rollbacking”状态才允许快照回滚到源云硬盘。
为指定云硬盘批量删除标签 功能介绍 为指定云硬盘批量删除标签。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/cloudvolumes/{volume_id}/tags/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 EVS.2088 云硬盘不支持retype 云硬盘retype前置检查失败。 请检查retype的目标类型是否支持、售罄。
快速入门 创建云硬盘
理控制台和基于HTTPS请求的API（Application programming interface）管理方式。 API方式 如果用户需要将公有云平台上的云硬盘集成到第三方系统，用于二次开发，请使用API方式访问云硬盘，具体操作请参见云硬盘API参考。 控制台方式 其他相关操
权限和授权项 权限及授权项说明 API版本信息查询 云硬盘 云硬盘Actions 云硬盘快照 云硬盘标签 云硬盘过户
云硬盘状态 云硬盘状态(API) 云硬盘状态（console） 说明 creating 正在创建 云硬盘处于正在创建的过程中。 available 可用 云硬盘创建成功，还未挂载给任何云服务器，可以进行挂载。 in-use 正在使用 云硬盘已挂载给云服务器，正在使用中。 error
第二十四次正式发布。 更新： 相关接口重新排版。 删除：“API版本信息查询”章节下的所有内容。 2023-01-19 第二十三次正式发布。 更新： 接受云硬盘过户，更新“约束与限制”格式。 2019-09-09 第二十二次正式发布。 本次变更说明如下： 增加TMS标签接口。 2019-06-21
只有当云硬盘的状态处于“可用”或“回滚数据失败”状态才允许快照回滚到源云硬盘。 backing-up 通过OpenStack原生API，可以直接通过快照创建备份，快照状态就会变为backing-up。 通过API对磁盘创建备份过程中，系统会自动创建快照，该快照状态为backing-up。 父主题： 附录
创建云硬盘 操作场景 本章节指导用户通过API创建云硬盘。API的调用方法请参见如何调用API。 以从快照创建云硬盘为例。 前提条件 您需要规划云硬盘所在的区域信息，并根据区域确定调用API的Endpoint，详细信息请参见使用前必读。 操作步骤 从快照创建云硬盘，请先查询云硬盘快照列表，获取快照信息。
状态码 正常 错误码状态 描述 200 OK 201 Created 202 Accepted 204 No Content 异常 错误码状态 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain_id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面查看账号ID。 图1 获取账号ID 父主题：
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
