Disk drive and device report

Generates the Disk Drive and Device Report.

Request

Security

Table 1. Roles capable of executing the Disk Drive and Device Report API method
Any Super User System Admin Security Admin Operator
  superUser systemAdmin

(readOnly and read/write)

   

HTTP method

GET /manager/api/{apiResponseType}/1.0/driveReport.adm HTTP/1.1 Host:{manager.dsnet}

Curl method

curl -u {admin}:{password} -k ”https://{manager.dsnet}/manager/api/{apiResponseType}/1.0/driveReport.adm“

Response

Information about each device and drive in the system.

JSON response example

{ 
   "responseStatus":"ok", 
   "responseHeader":{ 
      "now":1523596636539, 
      "status":"ok", 
      "requestId":"WtA9XMCoDksAACHFwBgAAAEK" 
   }, 
   "responseData":{ 
      "devices":[ 
         { 
            "id":1, 
            "alias":"dc-m3100-2334.cleversafelabs.com", 
            "site":{ 
               "id":1, 
               "name":"My Site" 
            }, 
            "model":"Manager 3100", 
            "version":"3.13.2.f917-damascus-3132-1", 
            "serial":"292783014002", 
            "driveThresholds":{ 
               "driveErrorThreshold":1, 
               "driveWarningThreshold":1 
            }, 
            "drives":[ 
               { 
                  "model":"ST1000NM0033-9ZM173", 
                  "firmware":"SN03", 
                  "serial":"Z1W12CMM", 
                  "scsiName":"sdb", 
                   ”deviceName“: ”sdb“,
                  "uuid":"eaf810ff-262d-4438-a179-a7d37c644403",
                  "driveUsage":"os",
                  "capacity":1000204886016, 
                  "chassisId":"main", 
                  "enclosureId":"front", 
                  "slotId":"0", 
                  "bay":"main:front:0 (OS drive)", 
                  "status":"ONLINE" 
               }, 
               { 
                  "model":"ST3000NM0033-9ZM178", 
                  "firmware":"SN03", 
                  "serial":"Z1Z0WKHT", 
                  "scsiName":"sda",
                   ”deviceName“: ”sda“, 
                  "uuid":"ba659f5f-61ea-453f-b798-bc2aae2fa47a:main:front:1", 
                  "driveUsage":"data",
                  "capacity":3000034656256, 
                  "sequence":"main:front:1", 
                  "chassisId":"main", 
                  "enclosureId":"front", 
                  "slotId":"1", 
                  "bay":"main:front:1", 
                  "status":"ONLINE" 
               }, 
               { 
                  "model":"ST3000NM0033-9ZM178", 
                  "firmware":"SN03", 
                  "serial":"Z1Y0G72F", 
                  "scsiName":"sda",
                   ”deviceName“: ”sda“, 
                  "uuid":"ba659f5f-61ea-453f-b798-bc2aae2fa47a:main:front:2", 
                  "driveUsage":"data",
                  "capacity":3000034656256, 
                  "sequence":"main:front:2", 
                  "chassisId":"main", 
                  "enclosureId":"front", 
                  "slotId":"2", 
                  "bay":"main:front:2", 
                  "status":"ONLINE" 
               } 
            ] 
         } 
      ] 
   } 
} 

Parameters

Table 2. Response parameters for Disk Drive and Device Report (driveReport) API method
Parameter Type Description
devices

array

Devices in the system.

site

String

Name of site that device is assigned to, if any.

alias

String

Alias that is given to device.

model

String

Device's model name.

version

String

Version of device.

serial

String

Device’s serial number.

cabinet

String

Name of cabinet to which device is assigned, if any.

slot

Integer

Slot number that device is in, if any.

drives

array

Drives associated with device.

sequence

Integer

Sequence value for device, if disk is a RAID disk.

model

String

Physical drive model or N/A if unavailable.

firmware

String

Physical drive firmware or N/A if unavailable.

serial

String

Physical drive serial number or N/A if unavailable.

scsiName

String

SCSI name for drive or N/A if unavailable.

deviceName

String

Device name for drive or N/A if unavailable.

bay

String

Bay identifiers in which drive is located or N/A if unavailable.

status

String

Status for disk drive.

chassisId

String

Chassis identifier for the drive
enclosureId

String

Enclosure identifier for the drive
slotId

String

Slot identifier for the drive