检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
API说明 获取单个专属分布式存储池详情 获取专属分布式存储池详情列表 查询所有磁盘详情 获取接口版本号列表 获取接口版本号详情
量、类型、创建时间等信息。 获取接口版本号列表 查询本服务的接口版本号列表。包括版本号、版本状态、版本发布时间等信息。 获取接口版本号详情 查询本服务的接口目标版本号详情。包括版本号、版本状态、版本发布时间等信息。 磁盘相关API请参见云硬盘API参考。
API授权项列表 API API功能 授权项 GET /v1/{project_id}/pools/{dss_id} 获取某个特定的专属分布式存储池详情。 dss:pools:get GET /v1/{project_id}/pools/detail 对租户开放查询专属分布式存储
获取接口版本号详情 功能介绍 查询本服务的接口目标版本号详情。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 api_version 是 String
获取接口版本号列表 功能介绍 查询本服务的接口版本号列表。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET / 请求消息 请求参数 无 请求样例 本示例展示了查询当前API所有版本信息。 GET https://{endpoint}/ 响应消息 响应参数
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
完整的状态码列表请参见错误码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于获取用户Token接口，返回如图1所示的消息头，其中“x-subject-tok
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
查询所有磁盘详情 请参考云硬盘API查询所有云硬盘详情。 父主题： API说明
状态码 正常 错误码状态 描述 200 OK 201 Created 202 Accepted 204 No Content 异常 错误码状态 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method
权限和授权项 权限及授权项说明 专属分布式存储池管理 磁盘管理
修订记录 发布日期 变更说明 2019-07-10 第三次发布。 更新API参考文档模板3.0。 新增“权限和授权项”。 2018-10-30 第二次发布。 API说明中新增“获取版本号列表”和“获取单个版本号详情”。 2018-03-30 第一次发布。
获取单个专属分布式存储池详情 功能介绍 获取某个特定的专属分布式存储池详情。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /v1/{project_id}/pools/{dss_id} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型
获取专属分布式存储池详情列表 功能介绍 获取租户申请的专属分布式存储池详情列表，支持过滤查询和分页查询。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /v1/{project_id}/pools/detail 参数说明请参见表1。 表1 参数说明 名称
附录 专属分布式存储池状态 错误码 状态码 获取项目ID API授权项列表
使用前必读 概述 调用说明 终端节点（Endpoint） 基本概念
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 错误码 状态码 错误码 错误信息 描述 处理措施 400 DSS.0001 invalid project id! URI中租户ID非法。 使用合法的project id。 400 DSS
磁盘管理 权限 对应API接口 授权项（Action） IAM项目 (Project) 企业项目 (Enterprise Project) 查询所有云硬盘详情 GET /v2/{project_id}/cloudvolumes/detail evs:volumes:list √ √
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
