Skip to main content
Hitachi Vantara Knowledge

Create a file system directory

Creates a file system directory.

HTTP request syntax (URI)
POST <base_URI>/v8/storage/filesystems/{filesystemId}/directories
Name Type Required Values Description
filesystemId URI_PARAM Y string Either the file system object ID or HNAS file system ID.
directory BODY Y string Full path of the directory to be created. The path should be in UNIX format.
ensureCreate BODY Y boolean When set to TRUE, the end result is similar to the mkdir -p command, which allows creating a directory even if its parent directory does not exist. For example, if /example does not exist in the file system, and directory has the value /example/subdirectory and the ensureCreate parameter is set to TRUE, then this operation can succeed.
Return codes
Code Data Description
201 directory File system directory has been successfully created.
400 Error Message Missing or invalid request contents.
403Error MessageOperation 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 201 indicates that the API did not complete successfully.

Request example 1: Create a directory using the file system object ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" -d ‘{"directory":"/new6/test/test4", "ensureCreate":true}’ -X POST
Request example 2: Create a directory using the HNAS storage file system ID
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" -d ‘{"directory":"/new6/test/test4", "ensureCreate":true}’ -X POST
Response example: Both requests produce the same response
HTTP/1.1 201 Created
   "directory" : {
      "displayName" : [ "//new6/test/test4" ],
      "name" : "test4",
      "objectId" : "73657368616e6577362f746573742f7465737434"
   "uri" : ""


  • Was this article helpful?