This is documentation for MapR Version 5.0. You can also refer to MapR documentation for the latest release.

Skip to end of metadata
Go to start of metadata

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

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

  • No labels