Delete consistency group snapshot image
The delete cgSnapImage consistencyGroup command deletes the snapshot images in a consistency group.
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.
Syntax
delete cgSnapImage consistencyGroup="<var id="GUID-186A7828-BD1D-4D33-AEF2-29F4919ED7D0__V1110101" className="keyword varname">consistencyGroupName</var>"
[deleteCount=<var id="GUID-186A7828-BD1D-4D33-AEF2-29F4919ED7D0__V1442528" className="keyword varname">numberOfSnapImages</var>]
[retainCount=<var id="GUID-186A7828-BD1D-4D33-AEF2-29F4919ED7D0__V1442529" className="keyword varname">numberOfSnapImages</var>]
[ignoreSnapVolume=(TRUE | FALSE)]
Parameters
| Parameter | Description |
|---|---|
| consistencyGroup | The name of the consistency group from which you want to delete the snapshot images. Enclose the consistency group name in double quotation marks (" "). |
| deleteCount | The number of snapshot images that you want to delete from the consistency group. Use integer values. This parameter deletes the oldest snapshot image first and continues to delete the oldest snapshot images until reaching the number that you enter. |
| retainCount | The number of snapshot images that you want to keep in the consistency group. Use integer values. This parameter keeps the most recent snapshot images in the consistency group. |
| ignoreSnapVolume | Determines whether the associated consistency group snapshot volume is kept or deleted. This parameter applies only if the consistency group snapshot image is associated with a consistency group snapshot volume. To keep the snapshot volume, set this parameter to TRUE . To delete the snapshot volume, set this parameter to FALSE . The default value is FALSE . |
Notes
If the snapshot images cannot be deleted for all of the relevant member volumes of the consistency group, the operation fails and none of the snapshot images are deleted.
When you delete a consistency group snapshot image that is associated with a consistency group snapshot volume, the corresponding snapshot volume member in the consistency group snapshot volume are transitioned to the Stopped state. A snapshot volume member in the Stopped state no longer has a relationship to the snapshot group of the deleted snapshot image. However, a snapshot volume member in the Stopped state keeps its relationship to its consistency group snapshot volume.