文档首页/ 专属分布式存储服务 DSS/ API参考/ API说明/ 获取单个专属分布式存储池详情
更新时间：2023-08-04 GMT+08:00
查看PDF
分享

获取单个专属分布式存储池详情

功能介绍

获取某个特定的专属分布式存储池详情。

URI

GET /v1/{project_id}/pools/{dss_id}

参数说明请参见表1。
表1 参数说明

名称

是否必选

参数类型

说明

project_id

是

String

项目ID。

获取方法请参考获取项目ID。

dss_id

是

String

专属分布式存储池ID。
表2 请求参数

名称

是否必选

参数类型

说明

usage

否

Boolean

当usage=true时，返回值带有专属分布式存储池容量信息，默认为false。

请求消息

请求样例

GET https://{endpoint}/v1/{project_id}/pools/{dss_id}?usage=true

响应消息

响应参数

响应参数如表3所示。
表3 响应参数

名称

参数类型

说明

name

String

专属分布式存储池名称。

id

String

专属分布式存储池ID。

project_id

String

专属分布式存储池归属的project_id。

capacity

Integer

申请的专属分布式存储池容量，单位GB。

type

String

专属分布式存储池的存储类型

  • SAS：高IO专属分布式存储池。
  • SSD：超高IO专属分布式存储池。

status

String

专属分布式存储池的状态，详细信息请参考专属分布式存储池状态。

availability_zone

String

专属分布式存储池所在AZ。

created_at

String

专属分布式存储池的创建时间。

时间格式：UTC YYYY-MM-DDTHH:MM:SS

total_capacity_gb

Integer

总容量（GB）（专属分布式存储池状态为deploying时，无该字段）。

used_capacity_gb

Integer

已使用容量（GB）（专属分布式存储池状态为deploying时，无该字段）。

provisioned_capacity_gb

Integer

已分配容量（GB）（专属分布式存储池状态为deploying时，无该字段）。

max_over_subscription_ratio

Float

超分比（专属分布式存储池状态为deploying时，无该字段）。
  • 响应样例 
    {
   "name" : "dedicatedStorage01",
   "id" : "c950ee97-587c-4f24-8a74-3367e3da570f",
   "project_id" : "63d910f2705a487ebe4e1c274748d9e1",
   "capacity" : 100,
   "type" : "SSD",
   "availability_zone" : "AZ1",
   "status" : "available",
   "created_at" : "2014-12-18T15:57:56.299000",
   "total_capacity_gb": 1000,
   "used_capacity_gb": 300,
   "provisioned_capacity_gb":700,
   "max_over_subscription_ratio": 1.0
}
  • 接口调用异常时，响应样例 
    {
  "error": {
    "message": "invalid dss id!",
    "code": "DSS.1001"
  }
}

返回值

错误码

请参考错误码。

父主题： API说明