6.3 HP StoreAll Storage File System User Guide (TA768-96093, June 2013)

the user can query all files in that directory only, or all files in all subdirectories of that directory
recursively.
Retention properties assignment
You can issue StoreAll REST API commands to change a file to the WORM (and optionally retained)
state and set its retention expiration time, subject to the file system’s retention policy settings.
General topics regarding HTTP syntax
Each feature is described in HTTP (with URL-encoded characters where required) and equivalent
curl formats, such as:
PUT command
Enter the following command on one line:
PUT /<urlpath>[/<pathname>]?[version=1]assign=<attribute1>='<value1>'
nl
[,<attribute2>='<value2>'…] HTTP/1.1
curl command
Enter the following command on one line:
curl -g -X PUT
"http[s]://<IP_address>:<port>/<urlpath>[/<pathname>]?[version=1]
nl
assign=<attribute1>='<value1>'[,<attribute2>='<value2>'…]"
When using this syntax, note the following:
• Optional parameters are shown in square brackets [ and ]. Everything enclosed in the brackets
can be omitted from the request. Do not include the square brackets in the request. For example,
the API supports either http or https for all requests, hence the http[s] nomenclature.
• Parameters are shown in angle brackets < and >. Replace the parameter with the actual value,
without the angle brackets.
• Other characters shown in the syntax (such as =, ?, &, and /) must also be entered as-is in
the request and sometimes must be URL-encoded.
• All parameters before the ? (such as pathname) should be entered as strings without any
surrounding quotes in standard URL format.
• All parameters after the ? (the query string in HTTP parlance) are either commands, attribute
names, or literals:
◦ Attribute names must be 80 characters or less. The first character must be alphabetic (a-z
or A-Z), followed by a sequence of alphanumeric characters or underscores. No other
characters are allowed. Colon characters (:) are allowed in system attribute names. All
attribute names are case-sensitive.
◦ Literals are either strings or numeric values.
◦ Literal strings must be enclosed in single quotes. Non-escaped UTF-8 characters are
allowed. Literals are case-sensitive. Any single quotes that are part of the string must be
escaped with a second single quote (no double quotes). For example:
'Dave''s book'
◦ Literal numeric values must not be enclosed by quotes, and are always in decimal (0-9).
Component overview 153