Set system drive
Sets the queue depth for a system drive on the storage system. This operation can also be used to enable or disable access to a system drive.
HTTP request syntax (URI)
PATCH <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. |
queueDepth | BODY | N | number | Queue depth. Value range is 16 to 512. A value of -1 resets the queue depth to the default for the particular drive type. |
enableAccess | BODY | N | boolean | True to allow the server access to the system drive or false to deny access. |
Return codes
Code | Data | Description |
204 | No Data | Queue depth of a system drive successfully set. |
400 | Error Message | Missing or invalid request contents. |
403 | Error Message | Operation forbidden by access level. |
404 | Error Message | Requested resource not found. |
500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 204 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/32313a3a3a4f49445f24232140255f56 -d '{"queueDepth": 49, "enableAccess": true}' -X PATCH
Response example: Using the system drive object ID
HTTP/1.1 204 No Content
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/21 -d '{"queueDepth": 49, "enableAccess": true}' -X PATCH
Response example: Using the HNAS storage system drive ID
HTTP/1.1 204 No Content