lsvdisk

Use the lsvdisk command to display a concise list or a detailed view of volumes that are recognized by the system.

Syntax

Parameters

-delim delimiter: (Optional) Specify a delimiter to separate data in the output.
-nohdr: (Optional) Suppress the headings in the output.
-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.
-filtervalue?: (Optional) Displays a list of valid filter attributes.

-unit b | kb | mb | gb | tb | pb: (Optional) Specifies the data units for the -filtervalue parameter.
-bytes: (Optional) Displays all capacities as bytes. Capacity values that are displayed in units other than bytes might be rounded. When you filter a capacity value, use a unit of bytes, -unit b, for exact filtering. For thin-provisioned copies, the capacity by tier contains the real capacities.
-showhidden: (Optional) Specifies that hidden volumes should be displayed. This includes snapshots, system-owned volumes, and volumes that are in the deleting state.
: (Optional) Specifies the name or ID of an object. When you use this parameter, the detailed view of the specific object is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the object_id | object_name parameter, the concise view of all objects that match the filtering requirements that are specified by the -filtervalue parameter are displayed.
id | name | uid: (Optional) Specifies the name, ID, or UID of an object. When you use this parameter, the detailed view of the specific object is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the id | name | uid parameter, the concise view of all objects that match the filtering requirements that are specified by the -filtervalue parameter are displayed.

Description

This command displays a concise list or a detailed view of attributes for all volumes and volume copies in the system.

You can encrypt volumes and volume copies. The volume is encrypted only if all volume copies are encrypted.

Note: During a migration of a volume (with one copy) between an encrypted and unencrypted storage pool the value is no.

The volume is not encrypted if the storage pool has a value of encrypt:no, including if the volume's extents are part of an encrypted MDisk or sequential volume.

The command returns values for the following volume attributes:

name: Indicates the name of the volume.
id: Indicates the ID of the volume.
capacity: Indicates the provisioned capacity of the volume that is the size of the volume as seen by the host.
internal_capacity: Indicates the capacity of the volume for which resources are allocated. This value can be greater than the provisioned capacity, if an attempt to expand the size of the volume failed while the volume was replicated.
vdisk_UID: Indicates the UID of the volume. If a volume is mapped to a host using the NVMe protocol, then the vdisk_UID value shows the Namespace Globally Unique Identifier (NGUID) for the volume.
status: The value can be online, offline, degraded, or deleting.

IO_group_id

Indicates the I/O group (ID) that the volume belongs to.

IO_group_name

Indicates the I/O group (name) that the volume belongs to.

mdisk_grp_id

Indicates the ID of the storage pool that the volume belongs to. If the volume has more than one copy, these fields display many.

mdisk_grp_name

Indicates the name of the storage pool that the volume belongs to. If the volume has more than one copy, these fields display many.

type

Indicates the virtualization type of the volume. The value can be striped, seq, image or many. The value many indicates that the volume has more than one copy, which can have different virtualization types.

formatted

Indicates whether the volume was formatted when it was created. The value can be yes or no.

formatting

Indicates whether the volume is formatting. The value can be yes or no.

mdisk_id

Indicates the MDisk ID that is used for sequential and image mode volumes. If the volume has more than one copy, these fields display many.

mdisk_name

Indicates the MDisk name that is used for sequential and image mode volumes. If the volume has more than one copy, these fields display many.

FC_id

Indicates the ID of the FlashCopy® mapping that the volume belongs to. The value many indicates that the volume belongs to more than one FlashCopy mapping.

FC_name

Indicates the name of the FlashCopy mapping that the volume belongs to. The value many indicates that the volume belongs to more than one FlashCopy mapping.

RC_id (Deprecated)

RC_name (Deprecated)

preferred_node_id

Indicates the ID of the preferred node for processing I/O to the volume.

fast_write_state

Indicates the cache state for the volume or volume copy. The value can be empty, not_empty, corrupt, or repairing. A cache state of corrupt indicates that the volume or volume copy requires repairing or recovery by using either the recovervdisk or repairvdiskcopy command.

cache

Indicates the cache mode of the volume. The value can be readonly, readwrite, or none.

fc_map_count

Indicates the number of FlashCopy mappings that the volume belongs to.

sync_rate

Indicates the rate for synchronization for mirrored copies.

copy_count

Indicates the number of volume copies that exist for this volume.

se_copy_count

Indicates the number of thin-provisioned copies.

Remember: This value represents only thin-provisioned copies and is not used for compressed volume copies.

filesystem

This field is always blank.

mirror_write_priority

Indicates the mirror write priority algorithm that is used if the volume is mirrored.

RC_change (Deprecated)

compressed_copy_count

Indicates the number of compressed volume copies.

access_IO_group_count

Indicates the number of I/O groups in the volume access set.

last_access_time

Indicates the time (YYMMDDHHMMSS) the volume last received I/O from any mapped host.

parent_mdisk_grp_id

Indicates the physical storage pool ID that the volume extents are allocated from.

parent_mdisk_grp_name

Indicates the physical storage pool name that the volume extents are allocated from.

owner_type

Indicates the type of owning component or object. The values are:

host_integration_metadata
accesspoint
cloud_backup
safeguarded_copy
none

The value is none if no owner is assigned.

owner_id

Indicates an identification number for the owning object.

owner_name

Indicates the name for owning object that owns this volume.

encrypt

Indicates whether all copies of a volume reside in MDisk groups (storage pools) that are reported as encrypting. This means that either one of the following things apply:

The copies reside in a storage pool that has an encryption key.
All MDisks in the group are self-encrypting or encrypted for RAID.

The values are yes and no.

volume_id

Indicates the volume ID (for a high availability volume).

volume_name

Indicates the volume name (for a high availability volume).

function (Deprecated)

throttle_id

Indicates the ID for the throttle object. The field is blank if no throttle is configured.

throttle_name

Indicates the name of the throttle object. The value is blank if no throttle is configured.

IOPs_limit

Indicates the IOPs limit that is configured for the volume. The value is blank if no limit is configured.

bandwidth_limit_MB

Indicates the bandwidth limit configured (in MB) for the volume. The value is blank if no limit is configured.

volume_group_id

Indicates the ID of the volume group this volume belongs to. This value is blank if the volume is not in a volume group.

volume_group_name

Indicates the name of the volume group this volume belongs to. This value is blank if the volume is not in a volume group.

cloud_backup_enabled

Indicates whether the cloud snapshot feature is enabled for the specified volume. The values are yes or no.

cloud_account_id

Indicates the cloud account ID.

cloud_account_name

Indicates the cloud account name.

backup_status

Indicates whether a new cloud snapshot can be started. If a backup is in progress, the status of the backup operation is given. The values are:

off
ready
copying
copying_error
not_ready

last_backup_time

Indicates the time (YYMMDDHHMMSS) of the most recent cloud snapshot for the volume.

restore_status

Indicates whether a restore can be performed for the volume. If a restore is in progress, the status of the restore operation is given. The values are:

none
available
restoring
restoring_error
committed
committing
committing_error

backup_grain_size

Indicates the grain size for the FlashCopy mappings that are used for the cloud snapshot function. The value is blank if cloud snapshot is not enabled.

Note: This sizing does not reflect the size of the grains that are stored in the cloud (which are fixed at 256 KB).

changevolume1_id

Indicates the ID of the associated change volume for the policy-based replication.

preferred_node_name

Indicates the name of the preferred node for processing I/O to the volume.

is_snapshot

Indicates the volume is a snapshot. Snapshots are hidden by default.

snapshot_count

Indicates the number of cloud snapshots associated with this volume.

volume_type

Indicates the type of volume.

source_volume_id

Indicates the ID of the source volume.

source_volume_name

Indicates the name of the source volume.

source_snapshot

Indicates the name of the source snapshot.

source_snapshot_timestamp

Indicates the timestamp of source snapshot (YYMMDDHHMMSS).

protection_provisioned_capacity

Indicates the amount of capacity provisioned to store point-in-time copies of this volume. This includes snapshots and consistency protection for replication.

protection_written_capacity

Indicates the amount of capacity written to store point-in-time copies of this volume before any data reduction. This includes snapshots and consistency protection for replication.

location1_volume_id

Indicates the ID of the volume in the first position of the topology diagram.

location2_volume_id

Indicates the ID of the volume in the second position of the topology diagram.

location3_volume_id

Indicates the ID of the volume in the third position of the topology diagram.

replication_mode

Indicates the replication mode of the volume on the local system. The field is blank if policy-based replication is not configured.

is_safeguarded_snapshot

Indicates the volume is a Safeguarded snapshot. Safeguarded snapshots are hidden by default.

safeguarded_snapshot_count

Indicates the number of Safeguarded snapshots associated with the volume.

restore_in_progress

Indicates whether a restore is currently in progress for the volume. The values are yes or no.

The command returns values for the following volume copy attributes:

copy_id

Indicates a system-assigned identifier for the volume copy. The value can be 0 or 1.

status

Indicates the status. The value can be online, offline, degraded, or deleting.

sync

Indicates whether the volume copy is synchronized.

auto_delete

Indicates that the primary copy is deleted after the secondary copy is synchronized. The values are yes or no.

primary

Indicates whether the volume copy is the primary copy. A volume has exactly one primary copy. The value can be yes or no.

mdisk_grp_id

Indicates the ID of the storage pool that the volume copy belongs to.

mdisk_grp_name

Indicates the name of the storage pool that the volume copy belongs to.

type

Indicates the virtualization type of the volume. The value can be striped, seq, or image.

mdisk_id

Indicates the MDisk ID that is used for sequential and image mode volumes.

mdisk_name

Indicates the MDisk name that is used for sequential and image mode volumes.

fast_write_state

used_capacity

Indicates the portion of real_capacity that is being used to store data. For non-thin-provisioned copies, this value is the same as the volume capacity. If the volume copy is thin-provisioned, the value increases from zero to the real_capacity value as more of the volume is written to. This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

real_capacity

Indicates the amount of physical storage that is allocated from a storage pool to this volume copy. If the volume copy is not thin-provisioned, the value is the same as the volume capacity. If the volume copy is thin-provisioned, the value can be different. This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

free_capacity

Indicates the difference between the real_capacity and used_capacity values. This field is blank for storage pools that are not thin-provisioned or compressed volume copies in a data reduction pool.

overallocation

Expressed as a percentage of the volume capacity, indicates the ratio of capacity to real_capacity values. This value is always 100 for non-thin-provisioned or compressed volumes. This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

autoexpand

Indicates whether autoexpand is enabled on a thin-provisioned volume. The value can be on or off.

warning

Expressed as a percentage of the volume capacity, this value indicates a warning for thin-provisioned or compressed volume copies. A warning is generated when the ratio of used_capacity to volume capacity reaches the specified level. This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

grainsize

For thin-provisioned volume copies, indicates the grain size that is chosen for the volume copy when it was created.

se_copy

Indicates whether the copy is thin-provisioned.

easy_tier

This value is set by the user and indicates whether Easy Tier® is permitted to manage the pool.

easy_tier_status

Indicates which Easy Tier functions are active.

tier

The tier information being reported.

tier_capacity

Indicates the total MDisk capacity that is assigned to the volume in the tier.

Note: For thin-provisioned copies, the capacity by tier is the real capacity.

compressed_copy

Indicates whether the volume copy is compressed.

uncompressed_used_capacity

For compressed volume copies, indicates the amount of data written to the volume copy before compression. This field is blank for volume copies in a data reduction storage pool.