Operation: get-storage-pool

 Home  Previous  Next

The get-storage-pool operation lists all of the available storage pools in the specified storage system as well as their characteristics (type, RAID level and available space notably).

This operation is almost a prerequisite to the create-lun operation to be able to specify in which pool a LUN needs to be created.
When no storage-system-name is specified, the operation lists all of the storage pools available in all storage systems (visible to the EMC SMI-S Provider). This can be useful to easily identify which disk arrays have the most space available.

Adapter Request Elements for 'get-storage-pool' Operation

 

Definition

Required

operation-name

Specifies the name of the operation you want to perform.

•Valid value: get-storage-pool.

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.

storage-system-name

Specifies the user defined storage system 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

Returns only the specified RAID group or thin pool details.

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

No

pool-type

Returns only the specified pool type details.

•Valid value: RG, or TP
•Default value: None.

No

Sample Adapter Request for 'get-storage-pool' Operation

<emc-storage-request>

  <operation-name>get-storage-pool</operation-name>

  <arguments>

    <argument>

      <storage-system-name/>

      <raid-group/>

      <thin-pool/>

      <pool-type/>

    </argument>

  </arguments>

</emc-storage-request>

Adapter Response Elements for 'get-storage-pool' Operation

 

Description

storage-system-name

Name of the storage system.

pool-type

Type of pool.

Possible values: RG or TP

raid-group

Name of the RAID group.

raid-level

RAID level of the storage pool.

disk-name

Name of the disk.

disk-type

Type of disk.

number-of-disks

Number of disks available in the storage pool.

size-bytes

Size of the storage pool in bytes.

size-gigabytes

Size of the storage pool in gigabytes.

capacity-bytes

Total capacity of the storage pool in bytes.

capacity-gigabytes

Total capacity of the storage pool in gigabytes.

available-capacity-bytes

Number of bytes available in the storage pool.

available-capacity-gigabytes

Number of gigabytes available in the storage pool.

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.

subscribed-capacity-bytes

Total host visible capacity in bytes.

subscribed-capacity-gigabytes

Total host visible capacity in gigabytes.

Sample Adapter Response for 'get-storage-pool' Operation

<emc-storage-response>

  <metadata>

    <status>success</status>

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

  </metadata>

  <responses>

    <response>

      <metadata>

        <status>success</status>

        <execution-milliseconds>11185</execution-milliseconds>

        <line-count>736</line-count>

        <pool-count>39</pool-count>

        <target>locke-2</target>

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

      </metadata>

      <output>

        <storage-pools>

          <storage-pool>

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

            <pool-type>RG</pool-type>

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

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

            <disk-names>

              <disk-name>0_0_5</disk-name>

              <disk-name>0_0_6</disk-name>

              <disk-name>0_0_7</disk-name>

              <disk-name>0_0_8</disk-name>

              <disk-name>0_0_9</disk-name>

            </disk-names>

            <disk-types>

              <disk-type>FC</disk-type>

              <disk-type>FC</disk-type>

              <disk-type>FC</disk-type>

              <disk-type>FC</disk-type>

              <disk-type>FC</disk-type>

            </disk-types>

            <number-of-disks>5</number-of-disks>

            <size-bytes>717513625600</size-bytes>

            <size-gigabytes>668.237</size-gigabytes>

            <capacity-bytes>574010884096</capacity-bytes>

            <capacity-gigabytes>534.589</capacity-gigabytes>

            <available-capacity-bytes>525449887744</available-capacity-bytes>

            <available-capacity-gigabytes>489.363</available-capacity-gigabytes>

            <consumed-capacity-bytes>48560996352</consumed-capacity-bytes>

            <consumed-capacity-gigabytes>45.226</consumed-capacity-gigabytes>

            <subscribed-capacity-bytes>48560996352</subscribed-capacity-bytes>

            <subscribed-capacity-gigabytes>45.226</subscribed-capacity-gigabytes>

          </storage-pool>

          <storage-pool>

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

            <pool-type>RG</pool-type>

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

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

            <disk-names>

              <disk-name>07A:C0</disk-name>

              <disk-name>08A:D0</disk-name>

              <disk-name>07B:D0</disk-name>

              <disk-name>08B:C0</disk-name>

              <disk-name>07C:C0</disk-name>

              <disk-name>08C:D0</disk-name>

              <disk-name>07D:D0</disk-name>

              <disk-name>08D:C0</disk-name>

            </disk-names>

            <disk-types>

              <disk-type>SATA</disk-type>

              <disk-type>SATA</disk-type>

              <disk-type>SATA</disk-type>

              <disk-type>SATA</disk-type>

              <disk-type>SATA</disk-type>

              <disk-type>SATA</disk-type>

              <disk-type>SATA</disk-type>

              <disk-type>SATA</disk-type>

            </disk-types>

            <number-of-disks>8</number-of-disks>

            <size-bytes>8001639077120</size-bytes>

            <size-gigabytes>7452.107</size-gigabytes>

            <capacity-bytes>7899138486944</capacity-bytes>

            <capacity-gigabytes>7356.646</capacity-gigabytes>

            <available-capacity-bytes>7724680082080</available-capacity-bytes>

            <available-capacity-gigabytes>7194.169</available-capacity-gigabytes>

            <consumed-capacity-bytes>174458404864</consumed-capacity-bytes>

            <consumed-capacity-gigabytes>162.477</consumed-capacity-gigabytes>

            <subscribed-capacity-bytes>147600375808</subscribed-capacity-bytes>

            <subscribed-capacity-gigabytes>137.464</subscribed-capacity-gigabytes>

          </storage-pool>

          <storage-pool>

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

            <pool-type>TP</pool-type>

            <thin-pool>ThinPool</thin-pool>

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

            <data-devices>

              <data-device>0008C</data-device>

              <data-device>000CB</data-device>

            </data-devices>

            <number-of-data-devices>1</number-of-data-devices>

            <size-bytes>1284243456</size-bytes>

            <size-gigabytes>1.196</size-gigabytes>

            <capacity-bytes>1284243456</capacity-bytes>

            <capacity-gigabytes>1.196</capacity-gigabytes>

            <available-capacity-bytes>1275592704</available-capacity-bytes>

            <available-capacity-gigabytes>1.188</available-capacity-gigabytes>

            <consumed-capacity-bytes>8650752</consumed-capacity-bytes>

            <consumed-capacity-gigabytes>0.008</consumed-capacity-gigabytes>

            <subscribed-capacity-bytes>8650752</subscribed-capacity-bytes>

            <subscribed-capacity-gigabytes>0.008</subscribed-capacity-gigabytes>

          </storage-pool>

        </storage-pools>

      </output>

    </response>

  </responses>

</emc-storage-response>