检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API说明 获取单个专属分布式存储池详情 获取专属分布式存储池详情列表 查询所有磁盘详情 获取接口版本号列表 获取接口版本号详情
调用说明 专属分布式存储服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
获取接口版本号详情 功能介绍 查询本服务的接口目标版本号详情。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 api_version 是 String
获取接口版本号列表 功能介绍 查询本服务的接口版本号列表。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET / 请求消息 请求参数 无 请求样例 本示例展示了查询当前API所有版本信息。 GET https://{endpoint}/ 响应消息 响应参数
API概览 专属分布式存储提供的具体API如表1所示。 表1 API接口 API 说明 获取单个专属分布式存储池详情 获取某个特定的专属分布式存储池详情。包括专属分布式存储池的名称、ID、容量、类型、创建时间等信息。 获取专属分布式存储池详情列表 获取租户申请的专属分布式存储池详
如何调用API 构造请求 认证鉴权 返回结果
API授权项列表 API API功能 授权项 GET /v1/{project_id}/pools/{dss_id} 获取某个特定的专属分布式存储池详情。 dss:pools:get GET /v1/{project_id}/pools/detail 对租户开放查询专属分布式存储
须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,用户要调用接口来查询云服务器列表,那么这个IAM用户被授予的策略中必须包含允许“ecs:ser
计费说明 计费项 专属分布式存储服务根据存储池类型、容量和购买量进行计费,具体请参见价格详情。 计费模式 仅支持包年计费模式,不支持按量付费。 变更配置 不支持修改存储池和磁盘类型。 仅支持扩容,不支持缩容。扩容请参见扩容存储池和扩容磁盘。 续费 如需续费,请在管理控制台续费管理
获取租户申请的专属分布式存储池详情列表,支持过滤查询和分页查询。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /v1/{project_id}/pools/detail 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 项目ID。
获取某个特定的专属分布式存储池详情。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /v1/{project_id}/pools/{dss_id} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 项目ID。
UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于获取用户Token接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体
权限和授权项 权限及授权项说明 专属分布式存储池管理 磁盘管理
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
修订记录 发布日期 变更说明 2019-07-10 第三次发布。 更新API参考文档模板3.0。 新增“权限和授权项”。 2018-10-30 第二次发布。 API说明中新增“获取版本号列表”和“获取单个版本号详情”。 2018-03-30 第一次发布。
完整的状态码列表请参见错误码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于获取用户Token接口,返回如图1所示的消息头,其中“x-subject-tok
查询所有磁盘详情 请参考云硬盘API查询所有云硬盘详情。 父主题: API说明
存储池容量说明 表1 存储池容量说明 容量种类 容量说明 申请容量 申请存储池时输入的容量大小。 裸容量 申请存储池的裸容量。 申请容量不低于裸容量的85%。 总可用容量 存储池可实际使用的容量。 已分配容量 存储池已分配容量。 含虚拟机/裸机/容器等使用的卷的分配容量、专属弹性文件服务(SFS
附录 专属分布式存储池状态 错误码 状态码 获取项目ID API授权项列表
使用前必读 概述 调用说明 终端节点(Endpoint) 基本概念