Operation: get-disk

 Home  Previous  Next

The get-disk operation lets administrators get the list of physical disks and their characteristics in the specified array. It is possible to specify the exact disk to be listed with the <disk> property or the RAID group the disk is a member of with the <raid-group> property.

noteThe get-disk operation is necessary before creating a RAID Group or Thin Pool using the create-storage-pool operation. To see whether a disk is already a member of a RAID Group or Thin Pool, you will need to check the presence of the <raid-group> or <thin-pool> tag of the adapter response.

noteIf all options are left blank, the get-disk operation will list all the physical disks installed in all the disk arrays managed by  the EMC SMI-S Provider.

Adapter Request Elements for 'get-disk' Operation

 

Definition

Required

operation-name

Specifies the name of the operation you want to perform.

•Valid value: get-disk.

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.

disk-name

Specifies the user defined disk name.

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

No

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

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

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

No

disk-type

Returns only the disk(s) that are of specified type.

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

No

Sample Adapter Request for 'get-disk' Operation

<emc-storage-request>

    <operation-name>get-disk</operation-name>

    <arguments>

     <argument>

      <storage-system-name />

      <disk-name />

      <disk-type />

      <raid-group />

      <thin-pool />

     </argument>

    </arguments>

  </emc-storage-request>

 

Adapter Response Elements for 'get-disk' Operation

 

Description

disk-name

Name of the disk.

disk-type

Type of disk.

storage-system-name

Name of the storage system.

raid-group

Name of the RAID group.

size-bytes

Size of the disk in bytes.

size-gigabytes

Size of the disk in gigabytes.

model

Model of the disk.

vendor

Name of the vendor.

operational-status

Operational status of the disk.

operational-status-description

Additional information about the status of the disk.

Sample Adapter Response for 'get-disk' Operation

<emc-storage-response>

  <metadata>

    <status>success</status>

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

  </metadata>

  <responses>

    <response>

      <metadata>

        <status>success</status>

        <execution-milliseconds>9126</execution-milliseconds>

        <line-count>2300</line-count>

        <disk-count>231</disk-count>

        <target>locke-2</target>

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

      </metadata>

      <output>

        <disks>

          <disk>

            <disk-name>0_0_0</disk-name>

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

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

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

            <size-bytes>143537471488</size-bytes>

            <size-gigabytes>133.68</size-gigabytes>

            <model>STT14685 CLAR146</model>

            <vendor>SEAGATE</vendor>

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

            <operational-status-description>OK</operational-status-description>

          </disk>

          <disk>

            <disk-name>0_0_1</disk-name>

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

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

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

            <size-bytes>143537471488</size-bytes>

            <size-gigabytes>133.68</size-gigabytes>

            <model>STT14685 CLAR146</model>

            <vendor>SEAGATE</vendor>

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

            <operational-status-description>OK</operational-status-description>

          </disk>

           <disk>

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

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

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

            <thin-pool>TP_R6_G2_FC</thin-pool>

            <size-bytes>1000204884640</size-bytes>

            <size-gigabytes>931.513</size-gigabytes>

            <model>ST310003CLAR1000</model>

            <vendor>SATAST</vendor>

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

            <operational-status-description>OK</operational-status-description>

          </disk>

          <disk>

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

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

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

            <thin-pool>joezr</thin-pool>

            <size-bytes>439049727480</size-bytes>

            <size-gigabytes>408.897</size-gigabytes>

            <model>STE45085 CLAR450</model>

            <vendor>SEAGATE</vendor>

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

            <operational-status-description>OK</operational-status-description>

          </disk>

        </disks>

      </output>

    </response>

  </responses>

</emc-storage-response>