You can use the ListVolumeStatsByVolumeAccessGroup method to list total activity measurements for all of the volumes that are members of the specified volume access groups.


This method has the following input parameters:

Name Description Type Default value Required
includeVirtualVolumes Virtual volumes are included in the response by default. To exclude virtual volumes, set to false. boolean true No
volumeAccessGroups An array of VolumeAccessGroupIDs for which volume activity is returned. If omitted, statistics for all volume access groups are returned. integer array None No

Return value

This method has the following return value:

Name Description Type
volumeStats List of volume activity information for all volumes in the specified volume access group.
Note: The volumeID member is 0 for each entry, because the values represent the summation of all volumes owned by the account.

Request example

Requests for this method are similar to the following example:

  "method": "ListVolumeStatsByVolumeAccessGroup",
    "params": {"volumeAccessGroups": [1]},
    "id": 1

Response example

This method returns a response similar to the following example:

  "id": 1,
  "result": {
    "volumeStats": [
        "accountID": 0,
        "nonZeroBlocks": 149366393,
        "readBytes": 3156273328128,
        "readBytesLastSample": 0,
        "readOps": 770574543,
        "readOpsLastSample": 0,
        "samplePeriodMSec": 500,
        "timestamp": "2016-10-17T21:04:10.712370Z",
        "unalignedReads": 0,
        "unalignedWrites": 0,
        "volumeAccessGroups": [
        "volumeID": 0,
        "volumeSize": 1073741824000,
        "writeBytes": 1051988406272,
        "writeBytesLastSample": 0,
        "writeOps": 256833107,
        "writeOpsLastSample": 0,
        "zeroBlocks": 112777607

New since version