检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API说明 获取单个专属分布式存储池详情 获取专属分布式存储池详情列表 查询所有磁盘详情 获取接口版本号列表 获取接口版本号详情
量、类型、创建时间等信息。 获取接口版本号列表 查询本服务的接口版本号列表。包括版本号、版本状态、版本发布时间等信息。 获取接口版本号详情 查询本服务的接口目标版本号详情。包括版本号、版本状态、版本发布时间等信息。 磁盘相关API请参见云硬盘API参考。
获取接口版本号详情 功能介绍 查询本服务的接口目标版本号详情。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 api_version 是 String
获取接口版本号列表 功能介绍 查询本服务的接口版本号列表。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET / 请求消息 请求参数 无 请求样例 本示例展示了查询当前API所有版本信息。 GET https://{endpoint}/ 响应消息 响应参数
如何调用API 构造请求 认证鉴权 返回结果
API授权项列表 API API功能 授权项 GET /v1/{project_id}/pools/{dss_id} 获取某个特定的专属分布式存储池详情。 dss:pools:get GET /v1/{project_id}/pools/detail 对租户开放查询专属分布式存储
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的获取用户Token来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987。
用Token认证调用其他API。 图1 获取用户Token响应消息头 响应消息体(可选) 该部分可选。响应消息体通常以结构化格式(如JSON或XML)返回,与响应消息头中Content-Type对应,传递除响应消息头之外的内容。 对于获取用户Token接口,返回如下消息体。为篇幅起见,这里只展示部分内容。
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 错误码 状态码 错误码 错误信息 描述 处理措施 400 DSS.0001 invalid project id! URI中租户ID非法。 使用合法的project id。 400 DSS
修订记录 发布日期 变更说明 2019-07-10 第三次发布。 更新API参考文档模板3.0。 新增“权限和授权项”。 2018-10-30 第二次发布。 API说明中新增“获取版本号列表”和“获取单个版本号详情”。 2018-03-30 第一次发布。
管理存储池和磁盘。 API文档 使用前必读 API概览 如何调用API API说明 常见问题 了解更多常见问题、案例和解决方案 热门案例 在使用专属分布式存储的过程中,不扩容可能存在哪些风险? 存储池有多少种状态? 磁盘有多少种状态? 使用专属分布式存储过程中的故障处理和影响? 一块磁盘可以挂载到多台云服务器上吗?
查询所有磁盘详情 请参考云硬盘API查询所有云硬盘详情。 父主题: API说明
获取单个专属分布式存储池详情 功能介绍 获取某个特定的专属分布式存储池详情。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /v1/{project_id}/pools/{dss_id} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型
附录 专属分布式存储池状态 错误码 状态码 获取项目ID API授权项列表
权限和授权项 权限及授权项说明 专属分布式存储池管理 磁盘管理
获取专属分布式存储池详情列表 功能介绍 获取租户申请的专属分布式存储池详情列表,支持过滤查询和分页查询。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /v1/{project_id}/pools/detail 参数说明请参见表1。 表1 参数说明 名称
使用前必读 概述 调用说明 终端节点(Endpoint) 基本概念
磁盘管理 权限 对应API接口 授权项(Action) IAM项目 (Project) 企业项目 (Enterprise Project) 查询所有云硬盘详情 GET /v2/{project_id}/cloudvolumes/detail evs:volumes:list √ √
专属分布式存储池状态 表1 专属分布式存储池状态 专属分布式存储池状态 说明 available 专属分布式存储池处于可用状态。 deploying 专属分布式存储池处于正在部署的过程中,不可使用。 extending 专属分布式存储池处于正在扩容的过程中,可使用。 父主题: 附录