功能介绍
获取某个特定的 专属分布式存储 池详情。
调试
您可以在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" } }
返回值
- 正常
- 异常
请参考错误码。
错误码
请参考错误码。