华为云计算 云知识 获取单个专属存储池详情ShowPool
获取单个专属存储池详情ShowPool

 

功能介绍

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

调试

您可以在API Explorer中直接运行调试该接口。

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"
      }
    }

返回值

错误码

请参考错误码

 

上一篇:应用运维遇到挑战 下一篇:华为云物联网平台的组成