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 on which to run the command. |
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
}
]
}
]
}