检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
控制台与弹性云服务器内部之间磁盘挂载点的对应关系 操作场景 登录弹性云服务器查询磁盘设备信息，发现磁盘的设备名称与控制台上显示的挂载点不一致，不清楚磁盘具体挂载在哪个设备上或磁盘对应的逻辑卷标识。本节操作介绍如何根据控制台上显示的磁盘信息，查询该磁盘在弹性云服务器内对应的设备名称。
起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创
与其他服务的关系 云硬盘与其他服务之间的关系，具体如图1所示。 图1 云硬盘与其他服务的关系示意图 表1 与其他服务的关系 交互功能 相关服务 位置 云硬盘可以挂载至弹性云服务器，提供可弹性扩展的块存储设备。 弹性云服务器（ECS, Elastic Cloud Server） 挂载非共享云硬盘
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET ht
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 EVS.2088 云硬盘不支持retype 云硬盘retype前置检查失败。 请检查retype的目标类型是否支持、售罄。
系统盘 × 数据盘 √ 包年/包月的云硬盘 随包年/包月云服务器购买的包年/包月云硬盘。 这种情况下，云硬盘和云服务器属于同一订单，有绑定关系，卸载后无法挂载至其他云服务器。 系统盘卸载后可以挂载至原云服务器用作系统盘或数据盘。 数据盘卸载后可以挂载至原云服务器用作数据盘。 单独购买的包年/包月云硬盘。
资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。 如何选择区域？
创建云硬盘 操作场景 本章节指导用户通过API创建云硬盘。API的调用方法请参见如何调用API。 以从快照创建云硬盘为例。 前提条件 您需要规划云硬盘所在的区域信息，并根据区域确定调用API的Endpoint，详细信息请参见使用前必读。 操作步骤 从快照创建云硬盘，请先查询云硬盘快照列表，获取快照信息。
设置云硬盘启动盘标识 功能介绍 设置云硬盘启动盘标识。 接口约束 数据盘调用本接口设置bootable后，也不能挂载到云主机作为系统盘使用。 调用方法 请参见如何调用API。 URI POST /v3/{project_id}/volumes/{volume_id}/action
se”）。 注意： 由于兼容性原因导致存在该接口，目前已经废弃。 接口约束 挂载云硬盘的操作不能调用该接口，只能调用ECS的Attach Volume接口。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/volumes/{volume_id}/action
取消保留云硬盘(废弃) 功能介绍 取消保留云硬盘。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/volumes/{volume_id}/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
able”） 注意： 由于兼容性原因导致存在该接口，目前已经废弃。 接口约束 卸载云硬盘的操作不能调用该接口，只能调用ECS的Detach Volume接口 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/volumes/{volume_id}/action
查询所有的可用分区信息 功能介绍 查询所有的可用分区信息。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/os-availability-zone 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
设置云硬盘启动盘标识（废弃） 功能介绍 设置云硬盘启动盘标识。 接口约束 数据盘调用本接口设置bootable后，也不能挂载到云主机作为系统盘使用。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/volumes/{volume_id}/action
创建云硬盘(废弃) 功能介绍 创建一个或多个云硬盘。 调用方法 请参见如何调用API。 URI POST /v3/{project_id}/cloudvolumes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 请求参数 表2 请求Header参数
查询单个云硬盘类型的详情（废弃） 功能介绍 查询单个云硬盘类型的详细信息。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/types/{type_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
查询云硬盘类型列表（废弃） 功能介绍 查询云硬盘类型列表。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/types 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见"获取项目ID"。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
