功能介绍
获取某个特定的 专属分布式存储 池详情。
调试
您可以在API Explorer中直接运行调试该接口。
URI
GET /v1/{project_id}/pools/{dss_id}
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
usage |
否 |
Boolean |
当usage=true时，返回值带有专属分布式存储池容量信息，默认为false。 |
请求消息
请求样例
GET https://{endpoint}/v1/{project_id}/pools/{dss_id}?usage=true
响应消息
响应参数
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
name |
String |
专属分布式存储池名称。 |
|
id |
String |
专属分布式存储池ID。 |
|
project_id |
String |
专属分布式存储池归属的project_id。 |
|
capacity |
Integer |
申请的专属分布式存储池容量，单位GB。 |
|
type |
String |
专属分布式存储池的存储类型
|
|
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" } }
返回值
- 正常
- 异常
请参考错误码。
错误码
请参考错误码。
