volume snapshot show
Display a list of snapshots
Description
- Vserver name
- Volume name
- Snapshot copy name
- State
- Size
- Percentage of total blocks in the parent volume
- Percentage of used blocks in the parent volume
- Creation time
- Snapshot busy
- List of the Snapshot copy's owners
- Comment associated with the Snapshot copy
- SnapMirror Label associated with the Snapshot copy
- Constituent Snapshot
- Expiry Time
- SnapLock Expiry Time
- Snapshot copy's Dataset ID
- Snapshot copy's master Dataset ID
- Number of consistency points in the Snapshot copy
- Internal status of the Snapshot copy
- File system version
- File system block format
- Physical Snap ID
- Logical Snap ID
- Database record owner
- Snapshot tags
- Instance UUID
- Version UUID
- Node
- AFS used size
- Compression savings size
- Deduplication savings size
- Vbn0 savings size
- Performance metadata size
- Status of FlexGroup Qtree support in the Snapshot copy
- State
- Size
- Percentage of total blocks in the parent volume
- Percentage of used blocks in the parent volume
At the admin and advanced privilege level, Snapshot copies whose parent volume is a FlexGroup Constituent are not displayed by default. To display these, run the commmand and set the is-constituent to true. At the diagnostic or higher privilege level, all Snapshot copies are displayed by default.
- Vserver name
- Volume name
- Snapshot copy name
- Creation time
By using the -fields option you can choose to print only the certain fields in the output. This presents the selected fields in a table view. This is ideal when you want additional information to be different from the information that is provided by the default table view, but would like it in a format which is visually easy to compare.
You can specify additional parameters to display the information that matches only those parameters. For example, to display information only about Snapshot copies of the load-sharing volumes, run the command with the -volume-type LS parameter. If you specify multiple filtering parameters, only those Snapshot copies that match all the specified parameters are displayed.
Parameters
- { [-fields fieldname, ...]
- If you specify the -fields fieldname, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
- | [-time ]
- If the -time format is specified, the command displays time related information about all entries.
- | [-instance ]}
- If you specify the -instance parameter, the command displays detailed information about all fields.
- [-vserver vserver name] - Vserver
- If you use this parameter, the Snapshot copies located only on the specified Vserver will be displayed.
- [-volume volume name] - Volume
- If you use this parameter only Snapshot copies located on the specified volume will be displayed.
- [-snapshot snapshot name] - Snapshot
- If you use this parameter only Snapshot copies matching the specified name will be displayed.
- [-dsid integer] - Snapshot Data Set ID (privilege: advanced)
- If this parameter is specified, the command displays information only about the Snapshot copy that has the specified data set ID.
- [-msid integer] - Snapshot Master Data Set ID (privilege: advanced)
- If this parameter is specified, the command displays information only about the Snapshot copy that has the specified master data set ID.
- [-create-time Date] - Creation Time
- If this parameter is specified, the command displays information only about the Snapshot copies that match the specified creation time.
- [-busy {true|false}] - Snapshot Busy
- If this parameter is specified, the command displays information only about the Snapshot copies that have the specified busy status.
- [-owners text, ...] - List of Owners
- If this parameter is specified, the command displays information only about the Snapshot copies that are owned by the specified list of owners.
- [-size {integer[KB|MB|GB|TB|PB]}] - Snapshot Size
- If this parameter is specified, the command displays information only about the Snapshot copies that have the specified size. The size is specified as a character specifying the unit of measurement after a number specifying the size in the mentioned unit of measurement: k (kilobytes), m (megabytes), g (gigabytes), or t (terabytes). If the unit of measurement is not specified, bytes are used as the unit, and the specified number is rounded up to the nearest 4 KB. You may also use an inequality such as 10 MB as input.
- [-blocks percent] - Percentage of Total Blocks
- If this parameter is specified, the command displays information only about the Snapshot copies that have the specified percentage of total blocks on their parent volumes. You may also use an inequality such as 10 as input.
- [-usedblocks percent] - Percentage of Used Blocks
- If this parameter is specified, the command displays information only about the Snapshot copies that have the specified percentage of used blocks on their parent volumes. You may also use an inequality such as 10 as input.
- [-cpcount integer] - Consistency Point Count (privilege: advanced)
- If this parameter is specified, the command displays information only about the Snapshot copies that have the specified number of consistency points. You may also use an inequality such as 100 as input.
- [-comment text] - Comment
- If this parameter is specified, the command displays information only about the Snapshot copies that have the specified comment text. You may also specify an inequality such as !"-" as input.
- [-fs-version text] - File System Version (privilege: advanced)
- If you use this parameter the only Snapshot copies displayed are those that were created when the file system was of a specific release. This parameter is helpful especially when you need to upgrade to newer software release and want to know the Snapshot copies that will be impacted by the upgrade process.
- [-logical-snap-id integer] - Logical Snap ID (privilege: advanced)
- If you use this parameter only those Snapshot copies which have the specified logical snapshot ID will be shown. Logical snapshot ids are internal implementation details of volume Snapshot copies.
- [-is-7-mode {true|false}] - 7-Mode Snapshot
- If you use this parameter only those Snapshot copies which have the specified value are shown. This value is true for the Snapshot copies that exist on the volume that was in 7-mode configuration and then transitioned to a clustered configuration. In such a scenario, the volume is in a clustered configuration and the existing Snapshot copies are still in the 7-mode configuration.NoteThe option related to 7-mode is not supported by Lenovo. Please contact Lenovo Support if you need any further assistance.
- [-snapmirror-label text] - Label for SnapMirror Operations
- If you use this parameter, only those Snapshot copies that have the specified SnapMirror Label value are shown.
- [-state {valid|invalid|partial|pre-conversion}] - Snapshot State
- If you use this parameter only those Snapshot copies which have the specified state will be shown.
- [-is-constituent {true|false}] - Constituent Snapshot
- If you use this parameter, only those Snapshot copies whose parent volume is a constituent volume of a FlexGroup will be shown.
- [-node nodename] - Node (privilege: advanced)
- If you use this parameter only those Snapshot copies that are located on the specified storage system are shown.
- [-inofile-version integer] - Snapshot Inofile Version (privilege: advanced)
- If this parameter is specified, the command displays information only about the Snapshot copies whose inode files are at the specified version.
- [-expiry-time MM/DD/YYYY HH:MM:SS] - Expiry Time
- If you use this parameter only those Snapshot copies that have the specified expiry time are shown.
- [-compression-type {none|secondary|adaptive}] - Compression Type (privilege: advanced)
- If you use this parameter only those Snapshot copies that have the specified compression type are shown.
- [-snaplock-expiry-time {MM/DD/YYYY HH:MM:SS [{+|-}hh:mm] | infinite}] - SnapLock Expiry Time
- If you use this parameter only those Snapshot copies that have the specified snaplock expiry time are shown.
- [-application-io-size {default|8K|16K|32K|auto}] - Application IO Size (privilege: advanced)
- If you use this parameter only those Snapshot copies that have the specified application IO size are shown.
- [-is-qtree-caching-enabled {true|false}] - Is Qtree Caching Support Enabled (privilege: advanced)
- If you use this parameter, only those Snapshot copies of FlexGroups or origin of a FlexCache volumes that have the specified Qtree caching status are shown.
Examples
The following example displays default information about all Snapshot copies of a volume named vol1:
cluster1:: volume snapshot show -volume vol1
---Blocks---
Vserver Volume Snapshot Size Total% Used%
-------- -------- ------------------------------------- -------- ------ -----
cluster1 vol1
one 68KB 0% 33%
two 72KB 0% 34%
2 entries were displayed.
cluster1:: volume snapshot show -create-time 1h -fields create-time, size
vserver volume snapshot create-time size
-------- ------ -------- ------------------------ ----
cluster1 vol1 one Mon Nov 17 10:23:42 2014 68KB
cluster1 vol1 two Mon Nov 17 10:23:44 2014 72KB
2 entries were displayed.
cluster1:: snap show -volume vol1 -snapshot one -instance
Vserver: cluster1
Volume: vol1
Snapshot: one
Snapshot Data Set ID: 4294968322
Snapshot Master Data Set ID: 6442451970
Creation Time: Mon Nov 17 10:23:42 2014
Snapshot Busy: false
List of Owners: -
Snapshot Size: 68KB
Percentage of Total Blocks: 0%
Percentage of Used Blocks: 33%
Consistency Point Count: 4
Comment: -
File System Version: 9.0
7-Mode Snapshot: false
Label for SnapMirror Operations: -
Constituent Snapshot: false
Node: node1
Snapshot Inofile Version: 3
Expiry Time: -
SnapLock Expiry Time: -