Skip to main content

Create read-only snapshot volume

The create snapVolume command creates a read-only snapshot volume for the snapshot images of a base volume. To change a read-only snapshot volume to a read/write volume, use the set snapVolume convertToReadWrite command.

Supported Arrays​

This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.

Roles​

To execute this command on an storage array, you must have the Storage Admin role.

Context​

Note
You cannot use this command for a snapshot image that is used in online volume copy.

Syntax​

create snapVolume userLabel="<var id="GUID-9AE0503F-19E1-4FC8-8527-DCF3B96074FF__V1111077" className="keyword varname">snapVolumeName</var>" 
snapImageID="<var id="GUID-9AE0503F-19E1-4FC8-8527-DCF3B96074FF__V1111044" className="keyword varname">snapCGID</var>:<var id="GUID-9AE0503F-19E1-4FC8-8527-DCF3B96074FF__V1512809" className="keyword varname">imageID</var>" 
readOnly

Parameters​

ParameterDescription
userLabel The name that you want to give to a snapshot volume. Enclose the snapshot volume name in double quotation marks (" ").
snapImageID

The name of a snapshot image that you want to add to the new read-only snapshot volume. The name of a snapshot image is comprised of two parts:

  • The name of the snapshot group

  • An identifier for the snapshot image in the snapshot group

The identifier for the snapshot image can be one of these:

  • An integer value that is the sequence number of the snapshot in the snapshot group.

  • NEWEST - Use this option when you want to show the latest snapshot image created in the snapshot group.
  • OLDEST - Use this option when you want to show the earliest snapshot image created in the snapshot group.

Enclose the snapshot image name in double quotation marks (" ").

readOnly

This parameter sets the snapshot volume to read-only. This parameter is actually a Boolean; however, in the context of this command, the Boolean value is always TRUE .

Note
With the readOnly parameter, snapshot volumes are not created.

Notes​

You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters.

The identifier of a snapshot image has two parts separated by a colon (:):

  • The name of the snapshot group

  • The identifier of the snapshot image

For example, if you want to create a read-only volume named engData1 using the most recent snapshot image in a snapshot group that has the name snapGroup1, you would use this command:


create snapVolume userLabel="engData1" snapImageID="snapGroup1:newest"
 readOnly;