- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 快速入门
- API
-
历史API
- API
-
Cinder API
-
云硬盘管理
- 查询单个云硬盘详情(废弃)
- 创建云硬盘(废弃)
- 创建云硬盘
- 查询所有云硬盘详情
- 删除云硬盘(废弃
- 删除云硬盘
- 更新云硬盘(废弃)
- 更新云硬盘
- 查询云硬盘类型列表(废弃)
- 查询云硬盘类型列表
- 查询单个云硬盘类型的详情(废弃)
- 查询单个云硬盘类型的详细信息
- 查询云硬盘列表(已废弃)
- 查询云硬盘列表
- 查询单个云硬盘详情(废弃)
- 查询单个云硬盘详情
- 查询所有云硬盘详情(废弃)
- 查询扩展接口(废弃)
- 查询扩展接口(废弃)
- 扩容云硬盘
- 扩容云硬盘(废弃)
- 设置云硬盘启动盘标识
- 将云硬盘导出为镜像
- 设置云硬盘启动盘标识(废弃)
- 设置云硬盘只读标识
- 设置云硬盘只读标识(废弃)
- 将云硬盘导出为镜像(废弃)
- 挂载云硬盘(废弃)
- 卸载云硬盘(废弃)
- 保留云硬盘(废弃)
- 取消保留云硬盘(废弃)
- 快照管理
- 配额管理
- 云硬盘过户管理
- 云硬盘元数据管理
- 快照元数据管理
- API版本查询
- 可用区查询
-
云硬盘管理
- 权限和授权项
- 附录
- 修订记录
- SDK参考
- 场景代码示例
-
常见问题
- 常见问题汇总
- 云硬盘通用问题
- 云硬盘计费问题
-
云硬盘挂载问题
- 为什么登录到云服务器后看不到已挂载的数据盘
- 云硬盘不支持挂载至云服务器怎么办
- 一块云硬盘可以挂载到多台云服务器上吗
- 云硬盘可以挂载至不同可用区的云服务器吗
- 怎样为云服务器增加数据盘(例如D盘或者dev/vdb1)
- 包年/包月云硬盘可以挂载给其他云服务器吗
- 不同类型的磁盘可以挂载在同一个云服务器上吗
- 系统盘和数据盘之间可以随意转换吗
- Linux系统的云硬盘挂载至Windows系统后需如何处理
- 随包周期云服务器购买的云硬盘,可以挂载至其它包周期云服务器吗
- 随云服务器购买的系统盘或数据盘可以换挂载点吗
- 控制台与弹性云服务器内部之间磁盘挂载点的对应关系
- 云硬盘挂载的包年/包月云服务器已到期,如何查看盘内数据
- 云硬盘扩容问题
- 云硬盘卸载问题
- 云硬盘删除问题
- 云硬盘容量问题
- 云硬盘快照问题
- 云硬盘性能问题
- 共享云硬盘问题
- 云硬盘备份问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
使用前必读
欢迎使用云硬盘(Elastic Volume Service, EVS)。云硬盘可以为云服务器提供高可靠、高性能、规格丰富并且可弹性扩展的块存储服务,可满足不同场景的业务需求,适用于分布式文件系统、开发测试、数据仓库以及高性能计算等场景。
您可以使用本文档提供API对云硬盘进行相关操作,如创建、查询、删除、更新等。支持的全部操作请参见API概览。
在调用云硬盘API之前,请确保已经充分了解云硬盘相关概念,详细信息请参见《云硬盘用户指南》的“产品介绍”。
调用说明
云硬盘提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。
同时云硬盘还提供多种编程语言的SDK供您使用,SDK的使用方法请参见SDK中心。
终端节点(Endpoint)
终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询云硬盘服务的终端节点。
约束与限制
- 您能创建的云硬盘资源的数量与配额有关系,如果您想查看服务配额、扩大配额,具体请参见“查看云硬盘资源配额”。
- 更详细的限制请参见具体API的说明。
基本概念
- 账号
用户注册时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用用户进行日常管理工作。
- 用户
由账号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。
在我的凭证下,您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。
- 区域(Region)
从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region,通用Region指面向公共租户提供通用云服务的Region;专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。
详情请参见区域和可用区。
- 可用区(AZ,Availability Zone)
一个可用区是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。
- 项目
区域默认对应一个项目,这个项目由系统预置,用来隔离物理区域间的资源(计算资源、存储资源和网络资源),以默认项目为单位进行授权,用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制,可以在区域默认的项目中创建子项目,并在子项目中创建资源,然后以子项目为单位进行授权,使得用户仅能访问特定子项目中的资源,使得资源的权限控制更加精确。
图1 项目隔离模型同样在我的凭证下,您可以查看项目ID。
- 企业项目
企业项目是项目的升级版,针对企业不同项目间的资源进行分组和管理,是逻辑隔离。企业项目中可以包含多个区域的资源,且项目中的资源可以迁入迁出。
关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理用户指南》。
API版本选择建议
API风格说明
- EVS服务自定义规范的API,以下简称为EVS自定义API。
- 顺从OpenStack社区标准原生规范的API,以下简称为Cinder API。
- 支持创建包周期的云硬盘
- 支持扩容包周期的云硬盘
- 支持企业项目管理
版本号介绍
EVS自定义API提供了多个版本。在接口功能相同的情况下,推荐您优先使用v2接口。
同时,针对创建、扩容云硬盘,还提供了v2.1接口,可以针对包周期云硬盘执行相关操作。
OpenStack Cinder API提供v2和v3版本,其中v3支持微版本号。