Skip to main content

volume recovery-queue show

Contributors
Suggest changes

Show volumes in the recovery queue

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

Description

The volume recovery-queue show command displays information about volumes in the recovery queue. The command output depends on the parameter(s) specified with the command. If no parameters are specified, the command displays the following information about all volumes:

  • Vserver name

  • Volume name

  • Deletion Request Time

  • Retention Hours

To display information about a single volume, run the command with the -vserver and -volume parameters.

To display detailed information about all volumes, run the command with the -instance parameter.

You can specify additional parameters to display information that matches only those parameters. For example, to display information only about volumes with retention hours 10, run the command with the -retention-hours 10 parameter.

Parameters

{ [-fields <fieldname>,…​]

This specifies the fields that need to be displayed. The fields Vserver and Volume are the default fields.

| [-instance ] }

If this parameter is specified, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver Name (privilege: advanced)

If this parameter and the -volume parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about volumes on the specified Vserver.

[-volume <volume name>] - Volume Name (privilege: advanced)

If this parameter and the -vserver parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about all volumes matching the specified name.

[-delete-time <Date>] - Deletion Request Time (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified delete time.

[-retention-hours <integer>] - Volume Delete Retention (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified retention hours.

[-instance-uuid <UUID>] - Volume Instance UUID (privilege: advanced)

If this parameter is specified, the command displays information only about the volume or volumes that match the specified instance uuid.

Examples

The following example displays information about all volumes on a Vserver named vs1 in the recovery queue:

cluster1::*> volume recovery-queue show -vserver vs1
Vserver   Volume      Deletion Request Time  Retention Hours
--------- ----------- ---------------------  ---------------
vs1       vol1_1234   Wed Aug 22 06:50:19 2012            10
vs1       vol2_1235   Wed Aug 22 06:50:26 2012            12
2 entries were displayed.

The following example displays detailed information about a volume named vol1_1234 on a Vserver named vs1 in the recovery queue:

cluster1::*> volume recovery-queue show -vserver vs1 -volume vol1_1234
Vserver Name: vs1
            Volume Name: vol1_1234
  Deletion Request Time: Wed Aug 22 06:50:19 2012
Volume Delete Retention: 10