Update a file system
Update file system parameters, including expansion limits, and whether thin provisioning is enabled or not.
This API call replaces Rename a file system for version 8 and incorporates the rename functionality.
HTTP request syntax (URI)
PATCH <base_URI>/v8/storage/filesystems/{filesystemId}
Parameters
Name | Type | Required | Values | Description |
filesystemId | URI_PARAM | Y | string | Either the file system object ID or HNAS file system ID. |
label | BODY | N | string | The new label for the file system. |
expansionLimits | BODY | N | Integer | Expansion limit of the file system in bytes. To remove the limit, set this value to 0. |
tier0ExpansionLimit | BODY | N | Integer | Expansion limit for tier 0 of a multi-tier file system in bytes. To remove the limit, set this value to 0. |
tier1ExpansionLimit | BODY | N | Integer | Expansion limit for tier 1 of a multi-tier file system in bytes. To remove the limit, set this value to 0. |
isThinProvisioned | BODY | N | Boolean | Thin provisioning status of the file system. |
Return codes
Code | Data | Description |
204 | No Data | File system successfully updated. |
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.
NoteWhen removing any of the expansion limits, the limit value will return to the theoretical maximum value that the file system can grow to.
Request example: Rename a file system using the file system object ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/filesystems/8659E4DE8E2FF4EA0000000000000000 –d '{"label":"TestFS"}' -X PATCH
Response example:
HTTP/1.1 204 No Content
Request example: Enable thin provisioning and set expansion limit for a file system
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/filesystems/8659E4DE8E2FF4EA0000000000000000 –d '{"isThinProvisioned":true, "expansionLimits":123456789}' -X PATCH
Response example:
HTTP/1.1 204 No Content