Delete a file system directory
Deletes a file system directory using the built in tree-delete functionality, which makes the delete operation appear to happen instantaneously.
HTTP request syntax (URI)
DELETE <base_URI>/v8/storage/filesystems/{filesystemId}/directories/{directoryObjectId}
Parameters
| Name | Type | Required | Values | Description |
| filesystemId | URI_PARAM | Y | string | Either the file system object ID or HNAS file system ID. |
| directoryObjectId | URI_PARAM | Y | string | Directory object ID. |
Return codes
| Code | Data | Description |
| 204 | No Data | File system directory has been successfully deleted. |
| 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 1: Delete a directory using the file system object ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.57.75:8444/v8/storage/filesystems/4141443145344135394346353032453430303030303030303030303030303030/directories/2f2f2f2f73657368616e6577362f74657374 -X DELETE
Request example 2: Delete a directory using the HNAS storage file system ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.57.75:8444/v8/storage/filesystems/864DC6E1DFB68C210000000000000000/directories/2f2f2f2f73657368616e6577362f74657374 -X DELETE
Response example: Both requests produce the same response
HTTP/1.1 204 No Content