Index  |  Top  -  Up Data ONTAP 8.2

volume snapshot show

Display a list of Snapshot copies

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

Description

The volume snapshot show command displays information about Snapshot copies. 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 Snapshot copies:

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 Snapshot copies, the detailed list view provides the following additional information: At the advanced or higher privilege level the detailed view provides the following additional information:

The list view is automatically enabled if a single Snapshot copy 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 Snapshot copies:

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 followed by 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 >10mb 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.

[-internal-status <text>] - Internal Status (privilege: advanced)

If this parameter is specified, the command displays information only about the Snapshot copies that have the specified internal status. You may also specify an equality such as !"-" 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.

[-fs-block-format {32-bit|mixed|64-bit}] - File System Block Format

If you use this parameter, the command displays only the Snapshot copies that have the specified file system block format.

[-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 clustered configuration. In such a scenario, the volume is in clustered configuration and the existing Snapshot copies are still in the 7-Mode configuration.

[-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}] - 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 an Infinite Volume 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.

Examples

The following example displays detailed information about all Snapshot copies of a volume named vol1:
cluster1::> volume snapshot show -volume vol1
                                                             ---Blocks---
Vserver Volume Snapshot                         State  Size  Total% Used%
------- ------ -------------------------------- ------ ----- ------ ----- 
vs1     vol1
               __mirror_ref_snapshot_2153852611 valid  184KB    20%    0%
               daily.2008-10-18_0010            valid  236KB    24%    0%
               daily.2008-10-19_0010            valid  188KB    20%    0%
               hourly.2008-10-19_0505           valid  184KB    20%    0%
               hourly.2008-10-19_0605           valid  184KB    20%    0%
               hourly.2008-10-19_0705           valid  184KB    20%    0%
               hourly.2008-10-19_0805           valid  184KB    20%    0%
               weekly.2008-10-07_0015           valid  220KB    23%    0%
               weekly.2008-10-14_0015           valid  232KB    23%    0%
vs1     vol1_dr
               __mirror_ref_snapshot_2153849126 valid   72KB     9%    0%
               __mirror_ref_snapshot_2153852611 valid     0B     0%    0%
               daily.2008-10-18_0010            valid  236KB    24%    0%
               daily.2008-10-19_0010            valid  188KB    20%    0%
               hourly.2008-10-19_0305           valid  188KB    20%    0%
               hourly.2008-10-19_0405           valid  188KB    20%    0%
               hourly.2008-10-19_0505           valid  184KB    20%    0%
               hourly.2008-10-19_0605           valid  184KB    20%    0%
               weekly.2008-10-07_0015           valid  220KB    23%    0%
               weekly.2008-10-14_0015           valid  232KB    24%    0%
16 entries were displayed.

The following example displays detailed information about all Snapshot copies and their file system block format:

cluster1::> volume snapshot show -fields fs-block-format
vserver volume snapshot fs-block-format
------- ------ -------- ---------------
vs      v32    s32      32-bit
vs      v64    s64      64-bit
2 entries were displayed.

Index  |  Top  -  Up Data ONTAP 8.2