Getting information about a specific drive

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
The request below allows you to get information about a specific drive by specifying the drive location (the location of the drive box).

Execution permission

Storage Administrator (View Only)

Request line

GET base-URL/v1/objects/drives/object-ID

Request message

Object ID

Specify the driveLocationId value obtained by getting information about the drive list.

Attribute

Type

Description

driveLocationId

string

(Required) Drive location (location of the drive box)

Query parameters

None.

Body

None.

Response message

Body
{
  "driveLocationId": "0-0",
  "driveTypeName": "SAS",
  "driveSpeed": 10000,
  "totalCapacity": 600,
  "driveType": "DKR5D-J600SS",
  "usageType": "DATA",
  "status": "NML",
  "parityGroupId": "1-6",
  "serialNumber": "123456789012345678901"
}

Attribute

Type

Description

driveLocationId

string

Drive location

driveTypeName

string

Drive type

driveSpeed

int

Drive rotation speed (rpm)

totalCapacity

long

Drive capacity (GB)

For this attribute, 1 GB is equal to 1,0003 bytes.

driveType

string

Drive type code

usageType

string

Purpose for which the drive is used

  • DATA: Data drive
  • SPARE: Spare drive
  • FREE: Unused drive

status

string

Status of the drive

  • NML: Normal
  • WAR: Part of the drive is blocked
  • CPY: Copying is in progress
  • CPI: Copying is incomplete
  • RSV: The spare drive cannot be used
  • FAI: The drive is blocked because of a failure
  • BLK: The drive is blocked because maintenance is being performed
  • Unknown or UNK: The status is unknown

parityGroupId

string

The parity group number of the parity group to which the drive belongs

This item is hidden when the drive does not belong to any parity group.

serialNumber

string

Serial number of the drive

Status codes

For details on the status codes of the request for this operation, see the description of HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100/ConfigurationManager/v1/objects/drives/0-0