检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 云硬盘所提供的接口分为EVS自定义API与Cinder API。 自定义API不依赖于OpenStack，Cinder API依赖于OpenStack。两套接口配合使用，可以帮助您完整的使用云硬盘的所有功能。
如何调用API 构造请求 认证鉴权 返回结果
API版本查询 查询API接口的版本信息 查询接口版本信息列表 父主题： Cinder API
查询API接口的版本信息 功能介绍 查询接口的指定版本信息。 调用方法 请参见如何调用API。 URI GET /{version} 表1 路径参数 参数 是否必选 参数类型 描述 version 是 String 查询的目标版本号。 取值为：v1、v2、v3。
API版本信息查询 本章节仅列出了云硬盘v2接口的授权信息。对于v3接口，如果提供的功能与v2接口一样，则授权信息也一致。
历史API API Cinder API
API 云硬盘管理 快照管理 可用区查询 父主题： 历史API
API 云硬盘管理 快照管理 配额管理 云硬盘标签管理 Job任务管理 可用区查询
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 EVS.2088 云硬盘不支持retype 云硬盘retype前置检查失败。
Cinder API 云硬盘管理 快照管理 配额管理 云硬盘过户管理 云硬盘元数据管理 快照元数据管理 API版本查询 可用区查询 父主题： 历史API
查询接口版本信息列表 功能介绍 查询接口版本信息列表。 调用方法 请参见如何调用API。 URI GET / 请求参数 无 响应参数 状态码： 300 表1 响应Body参数 参数 参数类型 描述 versions Array of Versions objects 版本信息。
快照管理 回滚快照到云硬盘(废弃) 父主题： API
查询单个云硬盘快照详细信息 查询云硬盘快照列表 查询云硬盘快照详细信息列表 更新云硬盘快照 创建云硬盘快照（废弃） 删除云硬盘快照 删除云硬盘快照（废弃） 更新云硬盘快照（废弃） 查询云硬盘快照列表（废弃） 查询云硬盘快照详情列表（废弃） 查询单个云硬盘快照详情（废弃） 父主题： Cinder API
通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 snapshot 是 CreateSnapshotOption object 快照信息。
云硬盘管理 查询所有云硬盘详情(废弃) 创建云硬盘(废弃) 查询单个云硬盘详情(废弃) 父主题： API
(废弃) 父主题： Cinder API
通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
配额管理 查询租户的详细配额 父主题： Cinder API
挂载云硬盘(废弃) 功能介绍 该接口只会改变云硬盘的状态（“available”变为“in-use”）。 注意： 由于兼容性原因导致存在该接口，目前已经废弃。 接口约束 挂载云硬盘的操作不能调用该接口，只能调用ECS的Attach Volume接口。
可用区查询 查询所有的可用分区信息 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
