PowerScale OneFS API Reference

PDF

Delete a directory

Deletes the directory at the specified path.

Request syntax

DELETE /namespace/<access_point>/<container_path>[?recursive=<Boolean>] HTTP/1.1
Host <hostname>[:<port>]
Date: <date>
Authorization: <signature>

Request query parameters


Parameter Name	Description	Default	Type	Required
recursive	Deletes directories recursively, when set to true. Returns an error if you attempt to delete a directory that is not empty, when set to false. When the recursive parameter is set to true, and there is an error deleting a child, the operation continues to delete other children. Only the last error is returned.	False	Boolean	No

Request headers

This call sends common request headers.

Response headers

This call returns common response headers.

Response body

No message body is returned upon success.

Example request

DELETE /namespace/folder1/folder2 HTTP/1.1
Host my_cluster:8080
Content-Length: <length>
Date: Thu, 22 Sep 2011 12:00:00 GMT
Authorization: <signature>

Example response

HTTP/1.1 204 No Content
Date: Thu, 22 Sep 2011 12:00:00 GMT
Content-Length: <length>
Connection: close
Server: Apache2/2.2.19