检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
权限和授权项 权限及授权项说明 API版本信息查询 云硬盘 云硬盘Actions 云硬盘快照 云硬盘标签 云硬盘过户
云硬盘状态 云硬盘状态(API) 云硬盘状态（console） 说明 creating 正在创建 云硬盘处于正在创建的过程中。 available 可用 云硬盘创建成功，还未挂载给任何云服务器，可以进行挂载。 in-use 正在使用 云硬盘已挂载给云服务器，正在使用中。 error
查询单个云硬盘过户记录详情（废弃） 功能介绍 查询单个云硬盘的过户记录详情，比如过户记录创建时间、ID以及名称等信息。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/os-volume-transfer/{transfer_id} 表1 路径参数 参数
查询单个云硬盘详情（废弃） 功能介绍 查询单个云硬盘详情。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/volumes/{volume_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
查询单个云硬盘详情（废弃） 功能介绍 查询单个云硬盘的详细信息。该接口已废弃，请使用性能更佳的接口。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/volumes/{volume_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
Error object 出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。 表6 Error 参数 参数类型 描述 code String 出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。 message String 出现错误时，返回的错误消息。 请求示例
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 EVS.2088 云硬盘不支持retype 云硬盘retype前置检查失败。 请检查retype的目标类型是否支持、售罄。
创建云硬盘 操作场景 本章节指导用户通过API创建云硬盘。API的调用方法请参见如何调用API。 以从快照创建云硬盘为例。 前提条件 您需要规划云硬盘所在的区域信息，并根据区域确定调用API的Endpoint，详细信息请参见使用前必读。 操作步骤 从快照创建云硬盘，请先查询云硬盘快照列表，获取快照信息。
关于企业项目ID的获取及企业项目特性的详细信息，请参考："企业管理用户指南"。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
将云硬盘导出为镜像 功能介绍 将系统盘或数据盘的数据导出为IMS镜像，导出的镜像在IMS的私有镜像列表中可以查 看并使用。 调用方法 请参见如何调用API。 URI POST /v3/{project_id}/volumes/{volume_id}/action 表1 路径参数 参数 是否必选
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain_id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面查看账号ID。 图1 获取账号ID 父主题：
查询云硬盘快照的元数据 功能介绍 查询云硬盘快照的元数据。 调用方法 请参见如何调用API。 URI GET /v3/{project_id}/snapshots/{snapshot_id}/metadata 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是
查询云硬盘快照详细信息列表 功能介绍 查询云硬盘快照详细列表信息。 调用方法 请参见如何调用API。 URI GET /v3/{project_id}/snapshots/detail 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
更新云硬盘快照的元数据 功能介绍 更新云硬盘快照的元数据。 调用方法 请参见如何调用API。 URI PUT /v3/{project_id}/snapshots/{snapshot_id}/metadata 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是
设置云硬盘启动盘标识 功能介绍 设置云硬盘启动盘标识。 接口约束 数据盘调用本接口设置bootable后，也不能挂载到云主机作为系统盘使用。 调用方法 请参见如何调用API。 URI POST /v3/{project_id}/volumes/{volume_id}/action
Error object 出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。 表8 Error 参数 参数类型 描述 code String 出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。 message String 出现错误时，返回的错误消息。 请求示例
硬盘状态由“available”变为“awaiting-transfer”。当云硬盘过户被接收后，云硬盘状态变为“available”。 接口约束 只有当云硬盘状态为available时，支持创建过户，其他不支持过户的约束如下： 包周期的云硬盘不支持过户。 冻结的云硬盘不支持过户。
将云硬盘导出为镜像（废弃） 功能介绍 将系统盘或数据盘的数据导出为IMS镜像，导出的镜像在IMS的私有镜像列表中可以查看并使用。 接口约束 云硬盘容量需≤1TB。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/volumes/{volume_id}/action
查询云硬盘列表(废弃) 功能介绍 查询所有云硬盘的概要列表。该接口已废弃，请使用性能更佳的接口。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/cloudvolumes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
