6.5 HP StoreAll OS User Guide

◦ 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).
• All HTTP query responses generated by the API code follow the JSON standard. No XML
response format is provided at this time.
• HTTP request messages have a practical limit of about 2000 bytes, and it can be less if certain
proxy servers are traversed in the network path.
URL encoding
HTTP query strings are URL-decoded by the API code. API clients must encode special characters,
such as greater-than character (>), by replacing them with their hexadecimal equivalent values as
shown by the examples in this section.
The API’s URL decoder interprets certain special characters properly without being URL encoded.
Before the question mark character (?) in any HTTP request URL, the following characters are safe
and do not need to be URL encoded:
/ : - _ . ~ @ #
After the question mark character (?), the following characters are safe and do not need to be URL
encoded:
= & #
All other characters must be URL encoded as their hexadecimal value as described in the ISO-8859-1
(ISO-Latin) standard. For example, the plus character (+) must be encoded as %2B, and the greater
than character (>) must be encoded as %3E.
Spaces can be encoded as either %20 or as the plus character (+), such as "my%20file.txt"
or "my+file.txt" for the file "my file.txt". The plus character (+) is converted to a space
when the URL is decoded by the API code. To include a plus character (+) in the URL, encode it
as %2B, such as "A%2B" instead of "A+".
If you are using a tool such as curl to send the HTTP request, the tool might URL-encode certain
characters automatically, although you might have to enclose at least part of the URL in quotes for
it to do so. The exact behavior depends on the tool.
In the curl examples shown in this section, the entire URL is enclosed in double quotes so that the
non-encoded characters can be shown for readability. The curl tool URL-encodes all required
characters within the double quotes correctly. If you are using a different tool or constructing the
URL programmatically or manually, ensure that the right characters are URL-encoded before sending
it over HTTP to the API.
Pathname parameters
The pathname parameter provided in HTTP requests throughout the syntax must be specified as a
relative path from the <urlpath>, including the file name.
The system metadata attribute system::path (which is available for metadata queries) and the
pathname in JSON must also be specified as a relative path from the <urlpath>, including the
file name, instead of relative to the file system mount point.
Optional version parameter
Every StoreAll REST API request accepts the version parameter anywhere in the request:
version=1
Component overview 219