Operation: get-lun

 Home  Previous  Next

The get-lun operation lists the available LUNs in the specified storage system, as well as their characteristics. This operation is helpful to get the characteristics and ID of a LUN that needs to be "mapped" to a new host.

The table below describes the input properties for this request. If not specified, the valid value for an element should be assumed to be any string.

Adapter Request Elements for 'get-lun' Operation

 

Definition

Required

operation-name

Specifies the name of the operation you want to perform.

•Valid value: get-lun.

Yes

arguments

Parent element for <argument> element.

Yes

argument

Specifies a list of arguments that is required for this operation

Yes

target

Specifies the connection information for an EMC SMI-S Provider.

•Valid value: The value specified for <target> element must be the same as the value that has been specified for the name attribute of <config> element in the adapter configuration. You can skip this element. In this case the request will be executed on the first defined adapter configuration. You can leave this element empty. In this case the request will be executed on the first defined adapter configuration.
•Default value: The first defined adapter configuration.

No

timeout-secs

Specifies the time in seconds after which the attempt to connect to the EMC SMI-S Provider times out. The "timeout-secs" specified in adapter request overrides the value specified in adapter configuration.

•Valid value: A numeric value which specifies the time in seconds.
•Default Value: 180, if no "timeout-secs" is provided in adapter configuration.

No

You can specify one or more of the following elements to retrieve specific information. If none of the elements is specified, then all the details are fetched.

lun-name

Specifies the user defined LUN name.

•Valid value: Please refer to the get-lun operation to list the valid values of this field.
•Default value: None.

No

storage-system-name

Specifies the user defined array name.

•Valid value: Please refer to the get-storage-system operation to list the valid values of this field.
•Default value: None.

No

raid-group

or

thin-pool

Return only the LUN(s) that are associated with this RAID group or thin pool.

•Valid value: None.
•Default value: None.

No

lun-type

Returns only the lun(s) that are of requested type.

•Valid value: Data Device, Thin Device, Regular Device (LUN), Reserved by the ComputerSystem (Vault).
•Default value: None.

No

Sample Adapter Request for 'get-lun' Operation

<emc-storage-request>

    <operation-name>get-lun</operation-name>

    <arguments>

            <argument>

          <storage-system-name/>

    <lun-name/>

    <raid-group/>

    <thin-pool/>

              </argument>

   </arguments>

</emc-storage-request>

Adapter Response Elements for 'get-lun' Operation

 

Description

lun-name

Name of the LUN.

lun-element-name

User friendly name of the LUN.

lun-type

Type of LUN.

storage-system-name

Name of the storage system.

raid-level

RAID level.

raid-group

Name of the RAID group.

size-bytes

Size of the LUN in bytes.

size-gigabytes

Size of the LUN in gigabytes.

consumed-capacity-bytes

Total size in bytes of the space actually allocated or reserved.

consumed-capacity-gigabytes

Total size in gigabytes of the space actually allocated or reserved.

current-controller

Current controller being used to access the LUN.

composite

Indicates whether the LUN is a composite.

operational-status

Operational status of the LUN.

Sample Adapter Response for 'get-lun' Operation

<emc-storage-response>

  <metadata>

    <status>success</status>

    <response-count>1</response-count>

  </metadata>

  <responses>

    <response>

      <metadata>

        <status>success</status>

        <execution-milliseconds>23088</execution-milliseconds>

        <line-count>3873</line-count>

        <lun-count>321</lun-count>

        <target>locke-2</target>

        <config-name>default</config-name>

      </metadata>

      <output>

        <luns>

          <lun>

            <lun-name>00000</lun-name>

            <lun-element-name>LUN 0</lun-element-name>

            <lun-type>Regular Device (LUN)</lun-type>

            <storage-system-name>CLARiiON+CKM00083900053</storage-system-name>

            <raid-level>RAID5</raid-level>

            <raid-group>0000</raid-group>

            <size-bytes>32212254720</size-bytes>

            <size-gigabytes>30</size-gigabytes>

            <consumed-capacity-bytes>32212254720</consumed-capacity-bytes>

            <consumed-capacity-gigabytes>30</consumed-capacity-gigabytes>

            <current-controller>SP_B</current-controller>

            <composite>yes</composite>

            <operational-status>2</operational-status>

          </lun>

          <lun>

            <lun-name>00002</lun-name>

            <lun-element-name>Volume 00002</lun-element-name>

            <lun-type>Reserved by the ComputerSystem (Vault)</lun-type>

            <storage-system-name>SYMMETRIX+000294901120</storage-system-name>

            <raid-level>Other RAID Level</raid-level>

            <raid-group>0002</raid-group>

            <size-bytes>5368709120</size-bytes>

            <size-gigabytes>5</size-gigabytes>

            <consumed-capacity-bytes>5368709120</consumed-capacity-bytes>

            <consumed-capacity-gigabytes>5</consumed-capacity-gigabytes>

            <composite>no</composite>

            <operational-status>2</operational-status>

          </lun>

          <lun>

            <lun-name>0009D</lun-name>

            <lun-element-name>Volume 0009D</lun-element-name>

            <lun-type>Data Device</lun-type>

            <storage-system-name>SYMMETRIX+000294901120</storage-system-name>

            <raid-level>RAID5</raid-level>

            <raid-group>0001</raid-group>

            <size-bytes>2147745792</size-bytes>

            <size-gigabytes>2</size-gigabytes>

            <consumed-capacity-bytes>2147745792</consumed-capacity-bytes>

            <consumed-capacity-gigabytes>2</consumed-capacity-gigabytes>

            <composite>no</composite>

            <operational-status>2</operational-status>

          </lun>

          <lun>

            <lun-name>0009C</lun-name>

            <lun-element-name>Volume 0009C</lun-element-name>

            <lun-type>Thin Device</lun-type>

            <storage-system-name>SYMMETRIX+000294901120</storage-system-name>

            <raid-level>RAID1</raid-level>

            <thin-pool>TestThinPool</thin-pool>

            <size-bytes>210370560</size-bytes>

            <size-gigabytes>0.196</size-gigabytes>

            <consumed-capacity-bytes>786432</consumed-capacity-bytes>

            <consumed-capacity-gigabytes>0.001</consumed-capacity-gigabytes>

            <composite>no</composite>

            <operational-status>2</operational-status>

          </lun>

        </luns>

      </output>

    </response>

  </responses>

</emc-storage-response>