lsvolumerestoreprogress

Use the lsvolumerestoreprogress command to display information about restore operation progress.

Syntax

Parameters

-filtervalue attribute=value

(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.

Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards:

The wildcard character is the asterisk (*).
The command can contain a maximum of one wildcard.
When you use a wildcard, enclose the filter entry within double quotation marks (""): lsvolumerestoreprogress -filtervalue volume_id="1*"

-nohdr

(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.

Note: If there is no data to be displayed, headings are not displayed.

-delim delimiter

(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

-filtervalue?

(Optional) Displays a list of valid filter attributes. The following filters for the lsvolumerestoreprogress command are valid:

volume_id
volume_name
task
status

volume_name | volume_id

(Optional) Indicates the volume name or ID for the volume that is restored. The value for volume name must be an alphanumeric string and the value for volume ID must be a number.

Description

This command displays information about restore operation progress.

This table provides the attribute values that can be displayed as output view data.

Table 1. lsvolumerestoreprogress output
Attribute	Description
volume_id	Indicates the volume ID for the volume that is restored. The value must be a number (or blank).
volume_name	Indicates the volume name for the volume that is restored. The value must be an alphanumeric string (or blank).
task	Indicates the type of task that is in progress. The value is `restore`.
status	Indicates the task status. The values are: `restoring` `restoring_error`
generation_id	Indicates the generation ID for the volume snapshot generation that is restored. The value must be a number.
backup_time	Indicates the time for the volume snapshot generation that is being restored to the cloud system (or available on the restore volume). The value must be in `YYMMDDHHMMSS` format for snapshot tasks or blank for deletion tasks.
progress	Indicates the task progress as a percentage. The value must be a number 0 - 100. The status is blank when the status is `uncommitted`.
error_sequence_number	Indicates a particular error number. The value must be a number (or blank).
volume_backup_id	Indicates the UID of the volume snapshot that is restored. The value must be a number 1 - 32.
restore_volume_id	Indicates the ID of the volume that is the target of the restore operation. This volume is either the production volume (which means that the restore volume ID is the same as the volume ID) or a temporarily restored volume that is automatically provisioned by the restore process. The value must be a number.
restore_volume_name	Indicates the name of the volume that is the target of the restore operation. This volume is either the production volume (which means that the restore volume name is the same as the volume name) or a temporarily restored volume that is automatically provisioned by the restore process. The value must be an alphanumeric string.

A concise invocation example

lsvolumerestoreprogress

The resulting output:

volume_id volume_name task    status          generation_id backup_time  progress error_sequence_number
2         vdisk2      restore restoring       17            160102104511 88       
21        vdisk21     restore restoring_error 4             160102105023 19                                 122

A detailed invocation example

lsvolumerestoreprogress vdisk2

The resulting output:

volume_id 2
volume_name vdisk2
task restore
status restoring
generation_id 17
backup_time 160102104511
progress 88
error_sequence_number
volume_backup_UID 600507680CA880DF1800000000000002 
restore_volume_id 2
restore_volume_name vdisk2