Retrieves virtual volumes in a file system.
HTTP request syntax (URI)
GET <base_URI>/v7/storage/virtual-volumes/{virtualServerId}/{filesystemId}
Parameters
| Name | Type | Required | Values | Description |
|---|---|---|---|---|
| virtualServerId | URI_PARAM | Y | number | Virtual server identification number. |
| filesystemId | URI_PARAM | Y | string | Unique identity of the file system. |
Return codes
| Code | Data | Description |
|---|---|---|
| 200 | virtualVolume | An array of objects of virtualVolume successfully retrieved. |
| 400 | No Data | Missing or invalid request contents. |
| 404 | Error Message | Requested resource not found. |
| 500 | Error message | Error associated with the storage system. |
| 501 | No Data | Server has not implemented the request operation on the resource. |
Any HTTP status code other than 200 indicates that the API did not complete successfully.
Request example
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.57.75:8444/v7/storage/virtual-volumes/5/7547FEE51E4FEC080000000000000000
Response example
HTTP/1.1 200 OK
{
"virtualVolumes": [
{
"emails" : [ "" ],
"fileCount" : 1,
"filesystemId" : "75412709E1CB9AAB0000000000000000",
"objectId" : "353a3a3a37353431323730394531434239414142303030303030303030303030303030303a3a3a33",
"name" : "xyz$name$with$dollar",
"path" : "/xyz-test",
"permanentId" : 8449077299320167083,
"totalVolumeCapacity" : 19520290816,
"usageVolumeCapacity" : 0,
"virtualServerId" : 5,
"virtualVolumeId" : 12
},
{
"emails" : [ "" ],
"fileCount" : 1,
"filesystemId" : "75412709E1CB9AAB0000000000000000",
"objectId" : "353a3a3a37353431323730394531434239414142303030303030303030303030303030303a3a3a35",
"name" : "xyz*name*with*star",
"path" : "/xyz-*path",
"permanentId" : 8449077299320167083,
"totalVolumeCapacity" : 19520290816,
"usageVolumeCapacity" : 0,
"virtualServerId" : 5,
"virtualVolumeId" : 4
}
]
}