Get a system drive
Retrieves a system drive on the storage system.
HTTP request syntax (URI)
GET <base_URI>/v8/storage/system-drives/{systemDriveId}
Parameters
Name | Type | Required | Values | Description |
systemDriveId | URI_PARAM | Y | string/number | Specifies either the system drive object ID or HNAS storage system drive ID. |
Return codes
Code | Data | Description |
200 | systemDrive | System drive successfully retrieved. |
400 | Error Message | Missing or invalid request contents. |
404 | Error Message | Requested resource not found. |
500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 200 indicates that the API did not complete successfully.
Request example: Using the system drive object ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/system-drives/3132313a3a3a4f49445f24232140255f56
Response example: Using the system drive object ID
HTTP/1.1 200 OK { "systemDrive": { "capacity": 322122547200, "comment": "", "controllerPort": "0D00", "externalLUN": "1", "internalLUN": "0036", "isAccessAllowed": true, "isAssignedToStoragePool": true, "isMirrorPrimary": true, "isMirrored": false, "label": "0036", "mirrorDriveUniqueId": "", "model": "OPEN-V", "objectId": "313a3a3a3a3a3a303a3a3a4f49445f24232140255f56", "queueDepth": -1, "rackName": "442029", "status": "OK", "subModel": "HM84", "systemDriveId": 1, "tier": "NO_TIER", "uniqueId": "31096614-12818-924508064-924500054", "vendor": "HITACHI" } }
Request example: Using the HNAS storage system drive ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/system-drives/3
Response example: Using the HNAS storage system drive ID
HTTP/1.1 200 OK { "systemDrive": { "capacity": 322122547200, "comment": "", "controllerPort": "0900", "externalLUN": "3", "internalLUN": "0038", "isAccessAllowed": true, "isAssignedToStoragePool": true, "isMirrorPrimary": true, "isMirrored": false, "label": "0038", "mirrorDriveUniqueId": "", "model": "OPEN-V", "objectId": "333a3a3a3a3a3a303a3a3a4f49445f24232140255f56", "queueDepth": -1, "rackName": "442029", "status": "OK", "subModel": "HM84", "systemDriveId": 3, "tier": "NO_TIER", "uniqueId": "31096614-12818-924508064-924500056", "vendor": "HITACHI" } }