6.2.12.10 lsvolumeattachment

List volume attachments.

Purpose

The lsvolumeattachment command displays information about Exascale volume attachments.

Syntax

lsvolumeattachment [ --protocol edv ] [ attachment-id [ attachment-id ] ... ] [ -l ] [ --detail ] [ --attributes attribute[,attribute] ... ] 
     [ --filter filter[,filter] ... ] [ --sort [-]attribute[,[-]attribute] ... ] [ --count value ]

lsvolumeattachment --protocol iscsi [ attachment-id [ attachment-id ] ... ] [ -l ] [ --detail ] [ --attributes attribute[,attribute] ... ] 
     [ --filter filter[,filter] ... ] [ --sort [-]attribute[,[-]attribute] ... ] [ --count value ]

Command Options

The options for the lsvolumeattachment command are:

• --protocol: Specifies the attachment protocol, either edv (Exascale Direct Volume) or iscsi. If not specified, edv is assumed.

• attachment-id: Identifies the volume attachment that you want to list information about. If not specified, the command displays information about all volume attachments.

• -l: Returns output in a long, tabular form.

• --detail: Lists all attributes in a detailed form.

• --attributes: Lists the specific attributes to display.

• --filter: Used to specify conditions for filtering the list output.

• --sort: Used to sort the output using the specified attributes.

• --count: Specifies the maximum number of results to report.

Usage Notes

Note the following information when using this command:

• Filter conditions are specified as: <attribute><operator><value>.

  The allowed operators are =, !=, >=, <=, >, and <.

  Multiple comma-separated filter conditions are combined using AND logic.

  Dates can be specified using the following formats:

  • yyyy-MM-dd''T''HH:mm:ss
  • yyyy-MM-dd (Time is assumed to be 00:00 AM)
  • HH:mm:ss (Date is assumed to be today)

  A date can also be followed by a timezone specification.

  Sizes can be specified using suffixes K, KB, M, MB, G, GB, T, TB. The suffix is not case-sensitive.

• Sorting attributes are specified as: [-]attribute. Multiple sort attributes are comma-delimited. The default sort order is ascending. For descending sort order, prefix the attribute name with -.

  For example, use the following to primarily sort by name in descending order, and use creation time in ascending order to further sort entries with the same name:

  --sort -name,createTime

Examples

Example 6-160 List an EDV Attachment Using an Attachment ID

The following example shows how to list attachment information for an Exascale Direct Volume by using an attachment ID. In the example, the attachment ID is 3:50e52177583f4be4bad68ac20b65001e.

@> lsvolumeattachment 3:50e52177583f4be4bad68ac20b65001e

Example 6-161 List Specific EDV Attachment Attributes

The following example shows how to list specific attributes of all EDV attachments. In the example, the attributes being listed are id and devicePath.

@> lsvolumeattachment --attributes id,devicePath

Example 6-162 List an iSCSI Volume Attachment Using an Attachment ID

The following example shows how to list information for an iSCSI volume attachment by using an attachment ID. In the example, the attachment ID is 2-2:50e52177583f4be4bad68ac20b65001e.

@> lsvolumeattachment --protocol iscsi 2-2:50e52177583f4be4bad68ac20b65001e

Example 6-163 List Specific Attributes of an iSCSI Volume Attachment

The following example shows how to list specific attributes of an iSCSI volume attachment. In the example, the attachment ID is 2-2:50e52177583f4be4bad68ac20b65001e, and the attributes being listed are initiatorIQN and targetPortal.

@> lsvolumeattachment --protocol iscsi 2-2:50e52177583f4be4bad68ac20b65001e --attributes initiatorIQN,targetPortal