Unassign a file system from its virtual server
Removes a filesystem from a virtual server. The filesystem must be unmounted to remove the assignment. Once the filesystem is unassigned, it can no longer be mounted, until it is reassigned to a virtual server.
If the file system is currently participating in a data migration path, removing it from a virtual server may result in unexpected loss of data. The ignoreMigrationPaths option will enable the deletion to proceed, despite the risks.
HTTP request syntax (URI)
POST <base_URI>/v8/storage/filesystems/{filesystemId}/unassign
Parameters
Name | Type | Required | Values | Description |
filesystemId | URI_PARAM | Y | string | Either the file system object ID or HNAS file system ID. |
ignoreMigrationPaths | BODY | N | boolean | True to force the removal, ignoring any potential migration paths. The default value is False. |
Return codes
Code | Data | Description |
204 | No Data | File system successfully unassigned from virtual server. |
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: Unassign a filesystem, ignoring any existing migration paths
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/filesystems/3836363236374331323541433731414230303030303030303030303030303030/unassign -X POST -d '{"ignoreMigrationPaths":true}'
Response example
HTTP/1.1 204 No Content