volume info

Displays information about the specified volume. For best results, use the -json option when running the command.

Syntax

CLI 
maprcli volume info
    [ -cluster <cluster name> ]
    [ -output terse | verbose ]
    [ -path <mount directory> ]
    [ -name <volume name> ]
    [ -columns <column name> ]
REST 
http[s]://<host>:<port>/rest/volume/info?<parameters>

Parameters

You must specify either name or path, but not both.

Parameter

Description

cluster

The cluster on which to run the command.
columns A comma-separated list of fields to return in the query. See the Fields table on the volume command page. Default: all

name

The volume name for which to retrieve information. Note: When issuing maprcli volume info -columns and marcli volume list -columns commands, the column for the volume name is volumename.

output

Whether the output should be terse or verbose. Default: verbose

path

The mount path of the volume for which to retrieve information.

Output

For definitions of the output fields, and short names for use with filters, see the Fields table on the volume command page.

# maprcli volume info -path /var/mapr/local/qa-node123.qa.lab/mapred -json
{
    "timestamp":1435182867317,
    "timeofday":"2015-06-24 02:54:27.317 GMT-0700",
    "status":"OK",
    "total":1,
    "data":[
        {
            "acl":{
                "Principal":"User mapr",
                "Allowed actions":[
                    "dump",
                    "restore",
                    "m",
                    "a",
                    "d",
                    "fc"
                ]
            },
            "creator":"mapr",
            "aename":"mapr",
            "aetype":0,
            "numreplicas":"1",
            "minreplicas":"1",
            "nsNumReplicas":"1",
            "nsMinReplicas":"1",
            "allowGrant":"false",
            "reReplTimeOutSec":"300",
            "replicationtype":"high_throughput",
            "rackpath":"/data/default-rack/qa-node123.qa.lab",
            "mirrorthrottle":"1",
            "accesstime":"June 24, 2015",
            "readonly":"0",
            "mountdir":"/var/mapr/local/qa-node123.qa.lab/mapred",
            "volumename":"mapr.qa-node123.qa.lab.local.mapred",
            "mounted":1,
            "quota":"0",
            "advisoryquota":"0",
            "snapshotcount":"0",
            "logicalUsed":"0",
            "used":"0",
            "snapshotused":"0",
            "totalused":"0",
            "scheduleid":0,
            "schedulename":"",
            "mirrorscheduleid":0,
            "volumetype":0,
            "mirrortype":3,
            "creatorcontainerid":2120,
            "creatorvolumeuuid":"-5855877963007989184:-3606114614473047771",
            "volumeid":28342821,
            "actualreplication":[
                0,
                100,
                0,
                0,
                0,
                0,
                0,
                0,
                0,
                0,
                0
            ],
            "nameContainerSizeMB":0,
            "nameContainerId":2120,
            "needsGfsck":false,
            "maxinodesalarmthreshold":"0",
            "dbrepllagsecalarmthresh":"0",
            "limitspread":"true",
            "partlyOutOfTopology":0,
            "auditVolume":0,
            "audited":0,
            "coalesceInterval":60
            "enableddataauditoperations":"getattr,setattr,chown,chperm,chgrp,getxattr,listxattr,setxattr,removexattr,read,write,create,delete,readdir,rmdir,createsym,lookup,rename,createdev,truncate,tablecfcreate,tablecfdelete,tablecfmodify,tablecfScan,tableget,tableput,tablescan,tablecreate,tableinfo,tablemodify,getperm",
            "disableddataauditoperations":"mkdir",
            "volumeAces":{
                "readAce":"p",
                "writeAce":"p",
            },
            "fixCreatorId":"false",
            "ReplTypeConversionInProgress":"0"
        }
    ]
}

Examples

CLI
maprcli volume info -path /tmp/ruthTest -json
REST
https://10.10.82.23:8443/rest/volume/info?path=%2Ftmp%2FruthTest