Skip to main content

volume snapshot show

Contributors
Suggest changes
PDFs

Display a list of snapshots

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The volume snapshot show command displays information about snapshots. The command output depends on the parameters specified with the command. If no parameters are specified, the command displays a table with the following information about all the available snapshots:

  • Vserver name

  • Volume name

  • Snapshot name

  • State

  • Size

  • Percentage of total blocks in the parent volume

  • Percentage of used blocks in the parent volume

To display a detailed list view with additional information, run the command and select the -instance view. In addition to the above mentioned information about the snapshots, the detailed list view provides the following additional information:

  • Creation time

  • Snapshot busy

  • List of the snapshot's owners

  • Comment associated with the snapshot

  • SnapMirror Label associated with the snapshot

  • 7-Mode Snapshot

  • Constituent Snapshot

  • Expiry Time

  • SnapLock Expiry Time

  • SnapLock Snapshot Expired

  • Seconds until SnapLock Snapshot Expiry

At the advanced or higher privilege level the detailed view provides the following additional information:

  • Snapshot's Dataset ID

  • Snapshot's master Dataset ID

  • Number of consistency points in the snapshot

  • Internal status of the snapshot

  • 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

  • Reserved size

  • Logical used size

  • Performance metadata size

  • Status of FlexGroup Qtree support in the snapshot

Note For snapshots whose parent volume is a FlexGroup, some information is not available and empty values will be displayed. This information includes:

  • State

  • Size

  • Percentage of total blocks in the parent volume

  • Percentage of used blocks in the parent volume

    All information is available for snapshots whose parent volume is a FlexGroup Constituent.

At the admin and advanced privilege level, snapshots whose parent volume is a FlexGroup Constituent are not displayed by default. To display these, run the command and set the is-constituent to true . At the diagnostic or higher privilege level, all snapshots are displayed by default.

The list view is automatically enabled if a single snapshot is specified by using the -vserver , -volume and -snapshot options together.

A preformatted query for displaying the time-related information is available by specifying the -time format specifier. This displays a table that contains the following fields for all the available snapshots:

  • Vserver name

  • Volume name

  • Snapshot 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 snapshots of the load-sharing volumes, run the command with the -volume-type LS parameter. If you specify multiple filtering parameters, only those snapshots 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 snapshots located only on the specified Vserver will be displayed.

[-volume <volume name>] - Volume

If you use this parameter only snapshots located on the specified volume will be displayed.

[-snapshot <snapshot name>] - Snapshot

If you use this parameter only snapshots 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 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 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 snapshots that match the specified creation time.

[-busy {true|false}] - Snapshot Busy

If this parameter is specified, the command displays information only about the snapshots that have the specified busy status.

[-owners <text>,…​] - List of Owners

If this parameter is specified, the command displays information only about the snapshots 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 snapshots 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 snapshots 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 snapshots 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 snapshots 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 snapshots 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 snapshots 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 snapshots that will be impacted by the upgrade process.

[-logical-snap-id <integer>] - Logical Snap ID (privilege: advanced)

If you use this parameter only those snapshots which have the specified logical snapshot ID will be shown. Logical snapshot ids are internal implementation details of volume snapshots.

[-is-7-mode {true|false}] - 7-Mode Snapshot

If you use this parameter only those snapshots which have the specified value are shown. This value is true for the snapshots 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 snapshots are still in the 7-mode configuration.

[-snapmirror-label <text>] - Label for SnapMirror Operations

If you use this parameter, only those snapshots that have the specified SnapMirror Label value are shown.

[-state {valid|invalid|partial|pre-conversion}] - Snapshot State

If you use this parameter only those snapshots which have the specified state will be shown.

[-is-constituent {true|false}] - Constituent Snapshot

If you use this parameter, only those snapshots 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 snapshots 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 snapshots 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 snapshots that have the specified expiry time are shown.

[-compression-type {none|secondary|adaptive}] - Compression Type (privilege: advanced)

If you use this parameter only those snapshots 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 snapshots that have the specified SnapLock expiry time are shown.

[-application-io-size <Application I/O Size>] - Application IO Size (privilege: advanced)

If you use this parameter only those snapshots 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 snapshots of FlexGroup volumes or origin of a FlexCache volumes that have the specified Qtree caching status are shown.

[-snaplock-snapshot-expired {true|false}] - Has the SnapLock Snapshot Expired

If this parameter is specified, the command displays information as to whether or not a locked snapshot has expired.

[-seconds-until-snaplock-snapshot-expiry <integer>] - Seconds until the SnapLock Snapshot Expiry

If this parameter is specified, the command displays remaining SnapLock expiry time (in seconds) of a locked snapshot.

Examples

The following example displays default information about all snapshots 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.

The following example displays snapshots which are older than 1 hour, limiting the output to wanted fields:

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.

The following example displays detailed information about a specific snapshot, using the 'snap' alias:

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: -
      SnapLock Snapshot Expired: -
Seconds until SnapLock Snapshot Expiry: -