功能介紹
獲取某個特定的 專屬分布式存儲 池詳情。
調(diào)試
您可以在API Explorer中直接運行調(diào)試該接口。
URI
GET /v1/{project_id}/pools/{dss_id}
|
名稱 |
是否必選 |
參數(shù)類型 |
說明 |
|---|---|---|---|
|
project_id |
是 |
String |
項目ID。 獲取方法請參考獲取項目ID。 |
|
dss_id |
是 |
String |
專屬分布式存儲池ID。 |
|
名稱 |
是否必選 |
參數(shù)類型 |
說明 |
|---|---|---|---|
|
usage |
否 |
Boolean |
當(dāng)usage=true時,返回值帶有專屬分布式存儲池容量信息,默認為false。 |
請求消息
請求樣例
GET https://{endpoint}/v1/{project_id}/pools/{dss_id}?usage=true
響應(yīng)消息
響應(yīng)參數(shù)
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
name |
String |
專屬分布式存儲池名稱。 |
|
id |
String |
專屬分布式存儲池ID。 |
|
project_id |
String |
專屬分布式存儲池歸屬的project_id。 |
|
capacity |
Integer |
申請的專屬分布式存儲池容量,單位GB。 |
|
type |
String |
專屬分布式存儲池的存儲類型
|
|
status |
String |
專屬分布式存儲池的狀態(tài),詳細信息請參考專屬分布式存儲池狀態(tài)。 |
|
availability_zone |
String |
專屬分布式存儲池所在AZ。 |
|
created_at |
String |
專屬分布式存儲池的創(chuàng)建時間。 時間格式:UTC YYYY-MM-DDTHH:MM:SS |
|
total_capacity_gb |
Integer |
總?cè)萘浚℅B)(專屬分布式存儲池狀態(tài)為deploying時,無該字段)。 |
|
used_capacity_gb |
Integer |
已使用容量(GB)(專屬分布式存儲池狀態(tài)為deploying時,無該字段)。 |
|
provisioned_capacity_gb |
Integer |
已分配容量(GB)(專屬分布式存儲池狀態(tài)為deploying時,無該字段)。 |
|
max_over_subscription_ratio |
Float |
超分比(專屬分布式存儲池狀態(tài)為deploying時,無該字段)。 |
- 響應(yīng)樣例
{ "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 } - 接口調(diào)用異常時,響應(yīng)樣例
{ "error": { "message": "invalid dss id!", "code": "DSS.1001" } }
返回值
- 正常
- 異常
請參考錯誤碼。
錯誤碼
請參考錯誤碼。
