getDeviceInfo

Returns information about the passed in object ID, which can be a physical device, a RAID device, or a mirror virtual device.

Request

<getDeviceInfo> 
   <objectID/>            
</getDeviceInfo>

Reply

<deviceSimpleInfo>
   <name/>
   <objectID/>
   <type/>
   <size/>
   <freeSize/>
   <shared/>
   <deviceRAID>
      <raidType/>
      <elementSize/>
      <stripeSize/>
      <restripeFlag/>
      <segmentInfo>
         <numSegments/>
         <segmented/>
      </segmentInfo>
   </deviceRAID>
   <mirrored/>
   <deviceMirror>
      <mirrorGroupStatus/>
      <mirrorGroupPercent/>
      <numMirrors/>
      <mirrorInfo>
         <id/>
         <mirrorPercent/>
      </mirrorInfo>
   </deviceMirror>
</deviceSimpleInfo>

Elements

name: Specifies the name of the device as assigned by Media Manager.
objectID: Specifies the device ID (for a non-mirrored virtual device) or specifies the mirror ID (for a mirrored virtual device).
type: Specifies the type of the object as assigned by Media Manager.
size: Specifies the total size of the object.
freeSize: Specifies the object's available size.
shared: Specifies if this is a shared device.
deviceRAID: Specifies this is a software RAID device and describes the RAID configuration.
raidType: Specifies the type of RAID device, such as RAID 0 or RAID 5.
elementSize: Specifies the size (in bytes) of the RAID segments. All segments must be of identical size.
stripeSize: Specifies the stripe size (in bytes) of the RAID device.
restripeFlag: Specifies the restripe status of the RAID device. A non0 value indicates that the RAID device is in the process of restriping.
segmentInfo: Specifies information about each segment.
numSegments: Specifies the number of segments in the RAID.
segmented: Specifies the ID of each segment as assigned by Media Manager.
mirrored: Specifies if the device is mirrored.
deviceMirror: Specifies if the device is a mirrored device (RAID 1- Mirroring) and describes the mirrored device.
mirrorGroupStatus: Specifies the status bits for the entire mirror device.
mirrorGroupPercent: Specifies the lowest remirror percentage of any segment in the entire mirror device. If the device is fully synchronized, the percentage is 100. If one segment is 63% sychronized and another is 77% synchronized, the percentage is 63.
numMirrors: Specifies the number of segments in the mirror device.
mirrorInfo: Specifies information about each segment's mirror.
id: Specifies the segment ID as assigned by Media Manager.
mirrorPercent: Specifies the percentage of how complete each remirror is for each segment.