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