The "dir" action (NS3)

Use this action to return the structure for a selected directory for a FileStore (NS3) storage group.

GET /[CP Code]/[Path] HTTP/1.1
Host: [Domain Prefix]-nsu.akamaihd.net
X-Akamai-ACS-Action: version=1&action=dir&format=xml
[Signature Header 1]
[Signature Header 2]

Required variables

Variable values are as follows:

  • [CP Code]: The unique CP Code that represents the root directory in the applicable NetStorage Storage Group.
  • [path]: If applicable, any additional sub-directories, ending with the target directory
Note: Typically, this action must be used to target a directory. If an actual file is included in the “ [path]”, an error will be revealed. (An “HTTP 412” will be displayed). The “ stat” action is used to display file information.
  • [Domain Prefix]: This is the unique domain prefix set up for the storage group during its creation. It can be viewed in the NetStorage Groups UI in Control Center.
  • [Signature Header 1] and [Signature Header 2]: Applicable signature headers.