volume balancinginfo

Fetch currently running or scheduled balancer information for one or more volumes.

Note: For best results, use the -json option when running the command.

Syntax

CLI
maprcli volume balancinginfo 
    [ -cluster cluster_name ]
    [ -name <volume name> ]
REST API
N/A

Parameters

Parameter Description
cluster The name of the cluster to run the command on.
name The name of the volume.

Output

The command returns the following fields:

Field Description
spId The ID of the storage pool.
capacity The capacity/size of the storage pool in MB.
usedSize The size of the storage pool that is consumed.
desiredSize The total size of the containers of a volume that should be allocated on this storage pool.
isUnderweight Value is true if the storage pool contains less than 50% of the desiredSize for this volume.
isOverweight Value is true if the storage pool contains more than 1.5 times the desiredSize for this volume.

Examples

Fetch the list of volumes whose balancing is currently in progress or scheduled:

maprcli volume balancinginfo -json

Fetch the balancing information for a volume:

maprcli volume balancinginfo -name snapshotVolume1 -json
Output:
{
  "timestamp":1502529117881,
  "timeofday":"2017-08-12 09:11:57.881 GMT+0000",
  "status":"OK",
  "total":5,
  "data":[
    {
      "volumeName":"snapshotVolume1"
    },
    {
      "isBalancingInProgress":false
    },
    {
      "numContainers":15
    },
    {
      "volumeSize":384
    },
    {
      "spInfo":[
        {
          "spId":"f891ae9e6663fa2000598ec48808155c",
          "capacity":152969,
          "usedSize":96,
          "desiredSize":95,
          "isUnderweight":false,
          "isOverweight":false
        },
        {
          "spId":"bed92c0ecfaefc8b00598ec48b01cdfe",
          "capacity":152969,
          "usedSize":96,
          "desiredSize":95,
          "isUnderweight":false,
          "isOverweight":false
        },
        {
          "spId":"b61aa1b814fd8bbc00598ec48d0af1d2",
          "capacity":157065,
          "usedSize":96,
          "desiredSize":97,
          "isUnderweight":false,
          "isOverweight":false
        },
        {
          "spId":"7af11d5b9d223baa00598ec4850efb57",
          "capacity":152969,
          "usedSize":96,
          "desiredSize":95,
          "isUnderweight":false,
          "isOverweight":false
        }
      ]
    }
  ]
}