Skip to main content

volume snapshot policy show

Contributors
Suggest changes
PDFs

Show snapshot policies

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

Description

The volume snapshot policy show command displays the following information about snapshot policies:

  • Vserver name

  • Snapshot policy name

  • Number of schedules in the policy

  • Comment for the policy

  • Individual schedule names

  • Maximum number of snapshots associated with each schedule

  • Snapshot name prefixes for the schedules

  • SnapMirror Labels associated with the schedules

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.

| [-revert-incompatible ] (privilege: advanced)

If this parameter is specified, the command displays snapshot policies that are not supported in ONTAP 8.2. The total snapshot count in the policy needs to be reduced to be equal to or less than the supported count for the revert operation to succeed.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver Name

If this parameter is specified, the command displays snapshot policies on the specified Vserver.

[-policy <snapshot policy>] - Snapshot Policy Name

If this parameter is specified, the command displays detailed information about the specified snapshot policy.

[-enabled {true|false}] - Snapshot Policy Enabled

If this parameter is specified, the command displays detailed information only about the snapshot policy or policies that have the specified enabled value.

[-comment <text>] - Comment

If this parameter is specified, the command displays information only about the snapshot policy or policies that have the specified comment.

[-total-schedules <integer>] - Total Number of Schedules in This Policy

If this parameter is specified, the command displays information only about the snapshot policy or policies that have the specified total number of schedules.

[-schedules <text>,…​] - Schedule Name

If this parameter is specified, the command displays information only about the snapshot policy or policies that have the specified list of schedules.

[-counts <integer>,…​] - Maximum Snapshots for the Schedule

If this parameter is specified, the command displays information only about the snapshot policy or policies that have the specified list of maximum numbers of snapshots per schedule.

[-prefixes <text>,…​] - Prefix Name

If this parameter is specified, the command displays information only about the snapshot policy or policies that have the specified list of prefixes.

[-snapmirror-labels <text>,…​] - Label for SnapMirror Operations

If this parameter is specified, the command displays information only about the snapshot policies that have the specified SnapMirror Label. When you specify a list of SnapMirror labels, the command displays all the snapshot policies that contain any of the SnapMirror Labels specified in the list.

[-policy-owner <text>] - Owner of the policy

If this parameter is specified, the command displays information only about the snapshot policies that have the specified policy owner.

[-total-count <integer>] - Total Number of Snapshots in This Policy

If this parameter is specified, the command displays information only about the snapshot policies that have the specified total number of snapshots.

[-retention-periods <snaplock minmax period>,…​] - SnapLock Retention Period

If this parameter is specified, the command displays information only about the snapshot policy or policies that have the specified retention-period set.

Examples

The following example displays information about all snapshot policies:

cluster1::> volume snapshot policy show
Vserver: cm
                         Number of Is
Policy Name              Schedules Enabled Comment
------------------------ --------- ------- ----------------------------------
default                          3 false   Default policy with hourly, daily  weekly schedules.
    Schedule               Count     Prefix                 SnapMirror Label
    ---------------------- -----     ---------------------- -------------------
    hourly                     6     hourly                 -
    daily                      2     daily                  -
    weekly                     2     weekly                 -

default-1weekly                  3 false   Default policy with 6 hourly, 2 daily  1 weekly schedule.
    Schedule               Count     Prefix                 SnapMirror Label
    ---------------------- -----     ---------------------- -------------------
    hourly                     6     hourly                 -
    daily                      2     daily                  -
    weekly                     1     weekly                 -

none                             0 false   Policy for no automatic snapshots.
    Schedule               Count     Prefix                 SnapMirror Label
    ---------------------- -----     ---------------------- -------------------
    -                          -     -                      -

Vserver: vs0
                         Number of Is
Policy Name              Schedules Enabled Comment
------------------------ --------- ------- ----------------------------------
p1                               1 false   -
    Schedule               Count     Prefix                 SnapMirror Label
    ---------------------- -----     ---------------------- -------------------
    weekly                     2     weekly                 -

p2                               2 true    -
    Schedule               Count     Prefix                 SnapMirror Label
    ---------------------- -----     ---------------------- -------------------
    hourly                     6     hourly                 -
    daily                      2     daily                  -

5 entries were displayed.