MapR 5.0 Documentation : volume snapshot list

Displays info about a set of snapshots. You can specify the snapshots by volumes or paths, or by specifying a filter to select volumes with certain characteristics.


Syntax

CLI

maprcli volume snapshot list
    [ -cluster <cluster> ]
    [ -columns <fields> ]
    ( -filter <filter> | -path <volume path list> | -volume <volume list> )
    [ -limit <rows> ]
    [ -output (terse\|verbose) ]
    [ -start <offset> ]

REST

http[s]://<host>:<port>/rest/volume/snapshot/list?<parameters>

Parameters

Specify exactly one of the following parameters: volume, path, or filter.


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 below. Default: none

filter

A filter specifying snapshots to preserve. See Filters for more information.

limit

The number of rows to return, beginning at start. Default: 0

output

Specifies whether the output should be terse or verbose. Default: verbose

path

A comma-separated list of paths for which to preserve snapshots.

start

The offset from the starting row according to sort. Default: 0

volume

A comma-separated list of volumes for which to preserve snapshots.


Fields

The following table lists the fields used in the sort and columns parameters, and returned as output.

Field

Description

snapshotid

Unique snapshot ID.

snapshotname

Snapshot name.

volumeid

ID of the volume associated with the snapshot.

volumename

Name of the volume associated with the snapshot.

volumepath

Path to the volume associated with the snapshot.

ownername

Owner (user or group) associated with the volume.

ownertype

Owner type for the owner of the volume: 

  • 0=user
  • 1=group

cumulativeReclainSizeMB

Disk space used for the snapshot, in MB.

creationtime

Snapshot creation time, milliseconds since 1970

expirytime

Snapshot expiration time, milliseconds since 1970; 0 = never expires.


Output

The specified columns about the specified snapshots.


Sample Output

creationtime   ownername  snapshotid  snapshotname                                   expirytime     diskspaceused  volumeid  volumename                 ownertype  volumepath
1296788400768  dummy      363         ATS-Run-2011-01-31-160018.2011-02-03.19-00-00  1296792000001  1063191        362       ATS-Run-2011-01-31-160018  1          /dummy
1296789308786  dummy      364         ATS-Run-2011-01-31-160018.2011-02-03.19-15-02  1296792902057  753010         362       ATS-Run-2011-01-31-160018  1          /dummy
1296790200677  dummy      365         ATS-Run-2011-01-31-160018.2011-02-03.19-30-00  1296793800001  0              362       ATS-Run-2011-01-31-160018  1          /dummy
dummy      1          14        test-volume-2  /dummy      102         test-volume-2.2010-11-07.10:00:00  0              1289152800001  1289239200001   

Output Fields

See the Fields table above.

Examples

List all snapshots:

CLI

maprcli volume snapshot list

REST

https://r1n1.sj.us:8443/rest/volume/snapshot/list

Save