PowerScale OneFS API Reference

PDF

Create a directory

Creates a directory with a specified path.

Request syntax

PUT /namespace/<access_point>/<container_path>[?recursive=<boolean>][?overwrite=<boolean>] HTTP/1.1
Host <hostname>[:<port>]
Content-Length: <length>
Date: <date>
Authorization: <signature>
x-isi-ifs-target-type: container

Request query parameters


Parameter Name	Description	Default	Type	Required
recursive	Creates intermediate folders recursively, when set to true.	False	Boolean	No
overwrite	Deletes and replaces the existing user attributes and ACLs of the directory with user-specified attributes and ACLS from the header, when set to true. Returns an error if the directory exists, when set to false. If the directory does not exist, the directory is created and set with the user-specified attributes and ACLs from the header. If no ACLs are set in the header, the default mode is set to 0700.	True	Boolean	No

Request headers


Header Name	Description	Default	Type	Required
x-isi-ifs-access-control	Specifies a predefined ACL value or POSIX mode with a string. If this parameter is not provided, the mode for the directory is set to 0700 by default.	0700 (read, write, and start with owner permissions)	String	No
x-isi-ifs-node-pool-name	Specifies the OneFS node pool name. When set to ANY, OneFS selects the pool for the directory. Only users with root access can set this header.	N/A	String	No
x-isi-ifs-attr-<attr_name>	Specifies extended user attributes on the directory. The attributes names are stored in upper case, and all dashes (-) are converted to underscores (_).	N/A	String	No

Response headers

This call returns common response headers.

Response body

No message body is returned upon success.

Example request

This request creates a directory on the namespace named 'folder1/folder2'.

PUT /namespace/ifs/folder1/folder2/?recursive=true HTTP/1.1
Host my_cluster:8080
x-isi-ifs-target-type: container
Content-Length: <length>
Date: Thu, 22 Sep 2011 12:00:00 GMT
Authorization: <signature>

Example response

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