volume snapshot remove
Removes one or more snapshots.
- License required: Enterprise Edition
- Permissions required:
fc
orm
on the volume
Syntax
- CLI
-
maprcli volume snapshot remove [ -cluster <cluster> ] ( -snapshotname <snapshot name> ] [ -snapshots <snapshots> ] [ -volume <volume name> ]
- REST
Request Type POST Request URL http[s]://<host>:<port>/rest/volume/snapshot/remove[?<parameters>]
Parameters
Specify both snapshot name and volume, or just snapshot ID.
Parameter | Description |
---|---|
cluster |
The cluster on which to run the command. |
snapshotname |
The name of the snapshot to remove. You must also specify the volume
name using the volume parameter. |
snapshots |
A comma-separated list of IDs of snapshots to remove. |
volume |
The name of the volume from which to remove the snapshot. This is
required if you are removing snapshot by specifying the snapshot name (using
snapshotname parameter). |
Examples
Remove the snapshot named "test-snapshot" associated with volume named "test-volume":
- CLI
-
maprcli volume snapshot remove -snapshotname test-snapshot -volume test-volume
- REST
-
curl -X POST 'https://abc.sj.us:8443/api/volume/snapshot/remove?snapshotname=test-snapshot&volume=test-volume' --user <username>:<password>
Remove two snapshots by ID:
First, use volume snapshot list
to
get the IDs of the snapshots you wish to remove. Example:
# maprcli volume snapshot list
snapshotid ownedsize sharedSize volumename ownername ownertype cumulativeReclaimSizeMB volumeid snapshotname creationtime volumepath volumeSnapshotAces
256000049 0 0 egVol mapr 1 0 29379677 egVol-snapshot Wed Sep 26 10:42:52 PDT 2018 /egVol ...
256000051 0 0 users mapr 1 0 212450174 uservolsnap Wed Sep 26 10:45:27 PDT 2018 /user ...
256000050 0 0 egVol mapr 1 0 29379677 egVolSnapshot Wed Sep 26 10:43:12 PDT 2018 /egVol ...
Use the IDs in the volume snapshot remove
command. For example, to
remove the first two snapshots in the above list, run the commands as follows:
- CLI
-
maprcli volume snapshot remove -snapshots 256000049,256000051 { "timestamp":1537986405764, "timeofday":"2018-09-26 11:26:45.764 GMT-0700 AM", "status":"OK", "total":0, "data":[ ] }
- REST
-
# curl -X POST 'https://server.sj.us:8443/rest/volume/snapshot/remove?snapshots=256000049,256000051' --user <username>:<password> {"timestamp":1537987406574,"timeofday":"2018-09-26 11:43:26.574 GMT-0700 AM","status":"OK","total":0,"data":[]}