使用說明
describeVolumes 是用於列出一組以上儲存空間的詳細資訊。 若沒有 volumeId 或 orderUuid 的參數，則會根據 vpcBusinessServiceId 及 businessTag 列出對應之儲存空間的資訊。 若均未填入以上參數，則會列出所有 CaaS 業務之儲存空間資訊。
Request參數
| 參數 | 說明 | 備註 |
|---|---|---|
volumeId (非必要參數) |
儲存空間識別碼列表 類型 : String 預設值 : 無 是否為複數型態 : 是 |
可支援多值 |
orderUuid (非必要參數) |
訂單編號 類型 : String 預設值 : 無 是否為複數型態 : 是 |
可支援多值 |
vpcBusinessServiceId (非必要參數) |
VPC平台識別碼 類型 : String 預設值 : 無 是否為複數型態 : 否 |
|
businessTag (非必要參數) |
業務類型 類型 : String 預設值 : 有 是否為複數型態 : 否 |
Response參數
| 參數 | 說明 | 備註 |
|---|---|---|
requestId (非必要參數) |
請求識別碼 類型 : JSON value : string 是否為複數型態 : 否 |
系統自動產生 |
| volumeList |
儲存空間資訊列表 類型 : JSON value : array 是否為複數型態 : 是 |
EbsEntry列表 |
Request範例
範例 1: (查詢所有CaaS儲存空間)
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeVolumes
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}
範例 2: (查詢指定儲存空間)
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeVolumes
&volumeId=BS550100010003
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}
範例 3: (查詢指定VPC平台之儲存空間)
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeVolumes
&vpcBusinessServiceId=VV550100010001
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}
Response範例
[
"requestId":"xxxEXAMPLE",
{
"orderUuid": "cvghe802-1ed4-4a2a-8078-ca0a29deeff0",
"volumeId": "BS550100010003",
"applyDate": "2012-01-01T01:01:01Z",
"startDate": "2012-01-01T01:02:01Z",
"endDate": null,
"name": "myVolume01",
"operationStatus": "mount",
"provisionStatus": "provisionok",
"provisionMessage": null,
"businessTag": "9a92f90c-532a-4a5d-9e3c-0c1805bc2583",
"radix": 1,
"instanceId": "BV550100010003",
"regionId": "region-tw-1"
},
{
"orderUuid": "pe0fkd0f-df4b-48d0-93bd-4f355c85b2d8",
"volumeId": "BS550100010004",
"applyDate": "2012-01-01T01:01:01Z",
"startDat": "2012-01-01T01:02:01Z",
"endDate": null,
"name": "myVolume02",
"operationStatus": "mount",
"provisionStatus": "provisionok",
"provisionMessage": null,
"businessTag": "9a92f90c-532a-4a5d-9e3c-0c1805bc2583",
"radix": 1,
"instanceId": "BV550100010004",
"regionId": "region-tw-1"
}
]