lsvolumebackupprogress

Use the lsvolumebackupprogress command to display information about the progress of snapshot operations.

Syntax

Read syntax diagramSkip visual syntax diagram lsvolumebackupprogress -filtervalueattribute_value-nohdr-delimdelimiter-filtervalue?

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 (""): lsvolumebackupprogress -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 lsvolumebackupprogress command are valid:
  • volume_UID
  • volume_id
  • volume_name
  • task
  • status

Description

This command display information about the progress of snapshot operations.

This table provides the attribute values that can be displayed as output view data.
Table 1. lsvolumebackupprogress output
Attribute Description
volume_UID Indicates the volume UID. The value must be a number 0 - 32 characters long.
volume_id Indicates the volume ID (if a volume with the specified UID exists on the local system). The value must be a number (or blank).
volume_name Indicates the volume name (if a volume with the specified UID exists on the local system). The value must be an alphanumeric string (or blank).
task Indicates the type of task that is in progress. The values are backup and delete.
status Indicates the task status. The values are:
  • copying
  • copying_error
  • deleting
  • deleting_error
generation_id Indicates the generation ID for the volume that is created or deleted. The value must be a number.
backup_time Indicates the snapshot time for the volume that is copied to the cloud system. 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 - 99.
error_sequence_number Indicates a particular error number. The value must be a number (or blank).

An invocation example

lsvolumebackuprogress

The resulting output:

volume_UID                       volume_id volume_name task   status        generation_id backup_time  progress  error_sequence_number
600507680CA880DF1800000000000002 2         vdisk2      backup copying       6             160218191005 88        
600507680CA880DF1800000000000015 15        vdisk15     backup copying_error 19            160218190845 12        122
600507680CA880DF1800000000000015 15        vdisk15     delete deleting      8                          5         
600507680CA880DF1800000000000017           vdisk108    delete deleting      10                         17        
600507680CA880DF1800000000000018           vdisk109    delete deleting      many                       55