Creating an empty directory

Content Platform Tenant Management Help

File Size
4269 KB
Part Number

You use the HTTP PUT method to create empty directories in a namespace. If any other directories in the path you specify for a new directory do not already exist, HCP creates them as well.

Access permission

To create a directory, you need write permission for the namespace.

Request header

PUT /rest/directory/new_dir?type=directory HTTP/1.1

The PUT request to create an empty directory has these elements:

  • If you’re accessing the namespace as an authenticated user, an Authorization header
  • A URL specifying the location in which to create the directory
Parameter Required Description
directory Yes Folder name.
new_dir Yes Name of the new directory you want to create.
type Yes Use the value directory to specify a directory object.

Response header

This creation operation does not return any request-specific response headers.

Status codes

Code Meaning Description
201 Created HCP successfully created the directory.
409 Conflict HCP could not create the directory in the namespace because a directory, object, or symbolic link with the specified name already exists.

Example: Creating an empty directory

Here’s a sample HTTP PUT request that creates a new directory named graphics in the quarterly_rpts directory.

Request with curl command line

curl -k -iX PUT
    -H "Authorization: HCP bXl1c2Vy:3f3c6784e97531774380db177774ac8d"

Request in Python using PycURL

import pycurl
curl = pycurl.Curl()
curl.setopt(pycurl.HTTPHEADER, ["Authorization: HCP
curl.setopt(pycurl.URL, " \
curl.setopt(pycurl.SSL_VERIFYPEER, 0)
curl.setopt(pycurl.SSL_VERIFYHOST, 0)
curl.setopt(pycurl.CUSTOMREQUEST, "PUT")
print curl.getinfo(pycurl.RESPONSE_CODE)

Request headers

PUT /rest/quarterly_rpts/graphics?type=directory HTTP/1.1
Authorizaton: HCP bXl1c2Vy:3f3c6784e97531774380db177774ac8d

Response headers

HTTP/1.1 201 Created
Location: /rest/quarterly_rpts/graphics
Content-Length: 0