Skip to main content

volume snapshot create

Contributors
Suggest changes
PDFs

Create a snapshot

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

Description

The volume snapshot create command creates a Snapshot copy of a specified volume.

Parameters

-vserver <vserver name> - Vserver

This specifies the Vserver that contains the volume on which the snapshot is to be created.

-volume <volume name> - Volume

This specifies the volume where a Snapshot copy is to be created.

-snapshot <snapshot name> - Snapshot

This specifies the name of the Snapshot copy that is to be created.

[-comment <text>] - Comment

This optionally specifies a comment for the Snapshot copy.

[-foreground {true|false}] - Foreground Process

If you use this option and select false , the Snapshot copy creation process runs in the background. If you use this option and select true , the Snapshot copy creation process runs in the foreground. The default is true .

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

If you specify this option, the Snapshot copy is created with the SnapMirror Label that you specify. If this option is not specified, the Snapshot copy is created with no SnapMirror Label. The SnapMirror Label is used by the Vaulting subsystem when you back up Snapshot copies to the Vault Destination.

[-expiry-time <MM/DD/YYYY HH:MM:SS>] - Expiry Time

If you specify this option, the Snapshot copy is created with the expiry time that you specify. The expiry time indicates the time at which the Snapshot copy becomes eligible for deletion.

[-snaplock-expiry-time {MM/DD/YYYY HH:MM:SS [{+|-}hh:mm] | infinite}] - SnapLock Expiry Time

This optionally specifies a snaplock-expiry-time for the Snapshot copy. A Snapshot copy with an expiry time cannot be deleted until the expiry time has elapsed. This option takes effect only on volumes with snapshot-locking-enabled set to true. If this option is not specified, the Snapshot copy will not be under retention.

Examples

The following example creates a Snapshot copy named vol3_snap on a volume named vol3 on a Vserver named vs0. The Snapshot copy is given the comment "Single snapshot" and the operation runs in the background.

cluster1::> volume snapshot create -vserver vs0 -volume vol3 -snapshot vol3_snapshot -comment "Single snapshot" -foreground false