API概览 专属分布式存储提供的具体API如表1所示。 表1 API接口 API 说明 获取单个专属分布式存储池详情 获取某个特定的专属分布式存储池详情。包括专属分布式存储池的名称、ID、容量、类型、创建时间等信息。 获取专属分布式存储池详情列表 获取租户申请的专属分布式存储池详情列表
DSS自定义策略 如果系统预置的DSS权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参考策略及授权项说明。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源
计费说明 计费项 专属分布式存储服务根据存储池类型、容量和购买量进行计费，具体请参见价格详情。 计费模式 仅支持包年计费模式，不支持按量付费。 变更配置 不支持修改存储池和磁盘类型。 仅支持扩容，不支持缩容。扩容请参见扩容存储池和扩容磁盘。
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 错误码 状态码 错误码 错误信息 描述 处理措施 400 DSS.0001 invalid project id! URI中租户ID非法。 使用合法的project id。 400 DSS
状态码 正常 错误码状态 描述 200 OK 201 Created 202 Accepted 204 No Content 异常 错误码状态 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method
调用说明 专属分布式存储服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
删除磁盘 操作场景 当磁盘不再使用时，请删除磁盘以释放虚拟资源。 当磁盘状态为“可用”、“错误”、“扩容失败”、“恢复数据失败”和“回滚数据失败”时，才可以删除磁盘。 对于共享磁盘，必须卸载所有的挂载点之后才可以删除。 操作步骤 登录管理控制台。 选择“专属分布式存储 > 磁盘”。
管理备份磁盘 操作场景 备份磁盘通过云备份服务提供的功能实现。 本章节指导用户为磁盘设置备份策略。通过备份策略，就可以实现周期性备份磁盘中的数据，从而提升数据的安全性。 只有当磁盘的状态为“可用”或者“正在使用”，则可以创建备份。 购买云硬盘备份存储库并设置备份策略 登录云备份管理控制台
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见错误码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证调用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高
查询所有磁盘详情 请参考云硬盘API查询所有云硬盘详情。 父主题： API说明
存储池有多少种状态 存储池有如下几种状态，每种状态的意义及支持的操作如表1所示。 表1 存储池状态 存储池状态 状态描述 支持的操作 正在部署 存储池正在创建部署。 - 可用 存储池创建成功，可以在存储池上创建磁盘。 创建磁盘 正在扩容 存储池处于正在扩容的过程中。 -
扩容存储池 操作场景 当存储池空间不足时，需要对原有存储池进行扩容。 扩容时按照存储池剩余时间收取扩容费用，扩容后存储池到期时间不变。 操作步骤 登录管理控制台。 选择“专属分布式存储 > 存储池”。在存储池列表选择需要进行扩容的存储池，在“操作”栏下单击“扩容”，进入“扩容存储池
获取接口版本号详情 功能介绍 查询本服务的接口目标版本号详情。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 api_version 是 String 目标版本号。 获取版本号请参考获取接口版本号列表。 请求消息
终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询专属分布式存储服务的终端节点。 父主题： 使用前必读
获取接口版本号列表 功能介绍 查询本服务的接口版本号列表。 URI GET / 请求消息 请求参数 无 请求样例 本示例展示了查询当前API所有版本信息。 GET https://{endpoint}/ 响应消息 响应参数 响应参数如表1所示。 表1 响应参数 参数名称 类型 说明
出现错误或失败的磁盘该如何处理 目前磁盘有以下异常状态，当处于这些状态时，请参考表1进行处理。 表1 磁盘异常状态处理建议 异常状态 建议 错误 您可以删除错误状态的磁盘后再重新创建。 删除失败 请联系客服解决。 扩容失败 客服会主动帮您解决此问题，在此之前建议不要对该磁盘做其他操作
获取单个专属分布式存储池详情 功能介绍 获取某个特定的专属分布式存储池详情。 URI GET /v1/{project_id}/pools/{dss_id} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 项目ID。 获取方法请参考获取项目
获取专属分布式存储池详情列表 功能介绍 获取租户申请的专属分布式存储池详情列表，支持过滤查询和分页查询。 URI GET /v1/{project_id}/pools/detail 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String
