GetVolumeEfficiency
You can use the GetVolumeEfficiency
method to get information about a volume. Only the volume you give as a parameter in this API method is used to compute the capacity.
Parameter
This method has the following input parameter:
Name | Description | Type | Default value | Required |
---|---|---|---|---|
volumeID |
Specifies the volume for which capacity is computed. |
integer |
None |
Yes |
Return values
This method has the following return values:
Name |
Description |
Type |
compression |
The amount of space being saved by compressing data on a single volume. Stated as a ratio, where 1 means data has been stored without being compressed. |
float |
deduplication |
The amount of space being saved on a single volume by not duplicating data. Stated as a ratio. |
float |
missingVolumes |
The volumes that could not be queried for efficiency data. Missing volumes can be caused by Garbage Collection (GC) being less than an hour old, temporary network loss or restarted services since the GC cycle. |
integer array |
thinProvisioning |
The ratio of space used to the amount of space allocated for storing data. Stated as a ratio. |
float |
timestamp |
The last time efficiency data was collected after GC. |
ISO 8601 data string |
Request example
Requests for this method are similar to the following example:
{ "method": "GetVolumeEfficiency", "params": { "volumeID": 606 }, "id": 1 }
Response example
This method returns a response similar to the following example:
{ "id": 1, "result": { "compression": 2.001591240821456, "deduplication": 1, "missingVolumes": [], "thinProvisioning": 1.009861932938856, "timestamp": "2014-03-10T16:06:33Z" } }
New since version
9.6