检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
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 Explorer中直接运行调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 api_version 是 String
获取接口版本号列表 功能介绍 查询本服务的接口版本号列表。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET / 请求消息 请求参数 无 请求样例 本示例展示了查询当前API所有版本信息。 GET https://{endpoint}/ 响应消息 响应参数
如何调用API 构造请求 认证鉴权 返回结果
状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见错误码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于获取用户Token接口，返回如图
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。T
专属分布式存储池归属的project_id。 capacity Integer 申请的专属分布式存储池容量，单位GB。 type String 专属分布式存储池的存储类型 SAS：高IO专属分布式存储池。 SSD：超高IO专属分布式存储池。 status String 专属分布式存储池的状态，详细信息请参考专属分布式存储池状态。
获取专属分布式存储池详情列表 功能介绍 获取租户申请的专属分布式存储池详情列表，支持过滤查询和分页查询。 调试 您可以在API Explorer中直接运行调试该接口。 URI GET /v1/{project_id}/pools/detail 参数说明请参见表1。 表1 参数说明
查询所有磁盘详情 请参考云硬盘API查询所有云硬盘详情。 父主题： API说明
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
错误码 当您调用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 √ √
对权限最小化的安全管控要求。 如果您要允许或是禁止某个接口的操作权限，请使用策略。 账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，
删除、更新等。支持的全部操作请参见API概览。 在调用专属分布式存储服务API之前，请确保已经充分了解专属分布式存储服务相关概念，详细信息请参见《专属分布式存储服务用户指南》的“产品介绍”。 存储池申请成功后，需要在存储池中创建磁盘。磁盘API请参见云硬盘API参考。 父主题： 使用前必读
附录 专属分布式存储池状态 错误码 状态码 获取项目ID API授权项列表
修订记录 发布日期 变更说明 2019-07-10 第三次发布。 更新API参考文档模板3.0。 新增“权限和授权项”。 2018-10-30 第二次发布。 API说明中新增“获取版本号列表”和“获取单个版本号详情”。 2018-03-30 第一次发布。
使用前必读 概述 调用说明 终端节点（Endpoint） 基本概念
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
