/mgmt/status/default/RaidPhysicalDriveStatus GET

Use the HTTP GET method with the /mgmt/status/default/RaidPhysicalDriveStatus resource to retrieve details about the RAID physical drives.

Resource URL

https://host:port/mgmt/status/default/RaidPhysicalDriveStatus
Where port is 5554 by default.

Request headers

The following header must be sent with the request:
Authorization
This header must be sent to perform authentication.

Request body format

None.

Security requirements

The caller must be authenticated as an appliance user with sufficient authority. For more information about security, see Types of user and how they are authenticated and User authorization, credential mapping, and access profiles.

Response status codes

200
Status information retrieved successfully.
400
Invalid data provided.
401
Not authenticated.
The caller must be authenticated as an appliance user. See Types of user and how they are authenticated for more information.
403
Not authorized.
The caller is authenticated but does not the authority to perform this action. See User authorization, credential mapping, and access profiles for more information.

Response headers

Content-Type
This header is returned with a value of application/json.

Response body format

The response is in JSON format. The response includes information about the RAID physical drives. Each object contains the following fields:
ControllerID
Integer.
The reference number of the RAID card. The value is always 1.
DeviceID
Integer.
The device identifier of the physical drive. Numbering starts with 1.
ArrayID
Integer.
The RAID array identifier to which this physical drive joins.
LogicalDriveID
Integer.
The logical drive identifier of which this physical drive is a part.
LogicalDriveName
String.
The name of the logical drive. The value is always 'raid0'.
Position
String.
The location of the physical drive from the front panel point-of-view of the appliance.
  • HDD0 The HDD0 drive is in the slot marked as 0 on the front panel.
  • HDD1 The HDD1 drive is in the slot marked as 1 on the front panel.
  • HDD2 The HDD2 drive is in the slot marked as 2 on the front panel.
  • HDD3 The HDD3 drive is in the slot marked as 3 on the front panel.
  • B5S1 The drive is in the first slot of the bay marked 5.
  • B5S2 The drive is in the second slot of the bay marked 5.
  • B7S1 The drive is in the first slot of the bay marked 7.
  • B7S2 The drive is in the second slot of the bay marked 7.
  • undefined Cannot detect the location of the drive.
State
String.
The current state of the physical drive.
  • unconfiguredGood The physical drive is good and available to be added in a RAID volume.
  • unconfiguredGoodForeign The physical drive is good, but the configuration was created by another system.
  • unconfiguredBad The physical drive is bad and cannot be added in a RAID volume. Replace this drive.
  • unconfiguredBadForeign The physical drive is bad and the configuration was created by another system. Replaced this drive.
  • hotSpare The physical drive is a hot spare disk.
  • offline The physical drive is configured and good, but the data is invalid.
  • failed The physical drive is configured but bad, all data is invalid and should be replaced.
  • rebuild The physical drive is configured and rebuilding.
  • online The physical drive is configured and good.
  • copyback The physical drive is getting copied.
  • system The physical drive is exposed and controlled by host.
  • undefined The physical drive state is undefined.
ProgressPercent
Integer.
The current progress percentage of the operation on the physical drive. Operations can be rebuild, copyback, patrol, or clear.
RawSize
Integer.
The exact size of the drive in megabytes.
CoercedSize
Integer.
The normalized size in megabytes. The value is rounded down to an even multiple, which allows you to swap drives of the same nominal size but might not be the same raw size.
InterfaceType
String.
The interface type of the drive.
  • unknown The drive type is unknown.
  • parallelSCSI The drive type is parallel Small Computer System Interface (SCSI).
  • sas The drive type is Serial Attached SCSI (SAS).
  • sata The drive type is Serial Advanced Technology Attachment (SATA).
  • fiberChannel The drive type is Fiber Channel.
  • undefined The drive type is not defined.
InterfaceSpeed
String.
The SAS interface speed negotiated between the RAID controller and the physical drive.
  • serial1point5GigabitsPerSecond The speed is 1.5 Gbps.
  • serial3point0GigabitsPerSecond The speed is 3.0 Gbps.
  • serial6point0GigabitsPerSecond The speed is 6.0 Gbps.
  • notApplicable Cannot detect the interface speed.
SASaddress
String.
The SAS address of a physical drive.
VendorID
String.
The vendor identification string for the hard disk drive.
ProductID
String.
The product identification string for the hard disk drive.
Revision
String.
The revision string of the hard disk drive from the vendor.
SpecificInfo
String.
The vendor specific information string that is read from the hard drive. Generally, the identifier is unique for each physical drive.
Failure
String.
If the hard disk failure state shows Yes, replace this drive as soon as possible to avoid possible data loss.
  • yes The physical drive has an error.
  • no The physical drive has no errors.
Temperature
String.
The temperature of the hard disk drive.

Examples

The following example requests information about the RAID phyical drives on the appliance.

The following URL is used with the HTTP GET method:
https://localhost:5554/mgmt/status/default/RaidPhysicalDriveStatus
The following listing shows an example received response:
{
  "_links": {
    "self": {
      "href": "/mgmt/status/default/RaidPhysicalDriveStatus"
    },
    "doc": {
      "href": "/mgmt/docs/status/RaidPhysicalDriveStatus"
    }
  },
  "RaidPhysicalDriveStatus": [
    {
      "ControllerID": 1,
      "DeviceID": 8,
      "ArrayID": 1,
      "LogicalDriveID": 1,
      "LogicalDriveName": "raid0",
      "Position": "HDD2",
      "State": "online",
      "ProgressPercent": 0,
      "RawSize": 1144641,
      "CoercedSize": 1143455,
      "InterfaceType": "sas",
      "InterfaceSpeed": "serial6point0GigabitsPerSecond",
      "SASaddress": "5000cca01daa4e050000000000000000",
      "VendorID": "IBM-ESXS",
      "ProductID": "HUC101212CSS60",
      "Revision": "J2M8",
      "SpecificInfo": "KZK0NHUHJ2M8J2M8J2M8",
      "Failure": "No",
      "Temperature": "33 / 91"
    },
    {
      "ControllerID": 1,
      "DeviceID": 9,
      "ArrayID": 1,
      "LogicalDriveID": 1,
      "LogicalDriveName": "raid0",
      "Position": "HDD1",
      "State": "online",
      "ProgressPercent": 0,
      "RawSize": 1144641,
      "CoercedSize": 1143455,
      "InterfaceType": "sas",
      "InterfaceSpeed": "serial6point0GigabitsPerSecond",
      "SASaddress": "5000cca01daa39990000000000000000",
      "VendorID": "IBM-ESXS",
      "ProductID": "HUC101212CSS60",
      "Revision": "J2M8",
      "SpecificInfo": "KZK0M4NHJ2M8J2M8J2M8",
      "Failure": "No",
      "Temperature": "33 / 91"
    }
  ]
}