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

11 HTTP-REST API file-compatible mode shares
The StoreAll REST API share in file-compatible mode provides programmatic access to user-stored
files and their metadata. The metadata is stored on the HP StoreAll Express Query database in the
StoreAll cluster and provides fast query access to metadata without scanning the file system. For
more information on managing Express Query, see “Express Query” (page 217).
The StoreAll REST API file-compatible mode provides the ability to upload and download files,
assign custom (user-defined) metadata to files and directories, manage file retention settings, and
query the system and custom metadata of files and directories. You can associate any number of
custom (user-defined) metadata attributes to any file or directory stored on a StoreAll
retention-enabled file system where the Express Query metadata store is enabled. Each custom
attribute consists of an attribute name and assigned value. The API provides commands to create
custom metadata entries for a file, replace values of existing entries, and delete entries. You can
create HTTP-StoreAll REST API shares to access Express Query on the file system.
When the StoreAll server receives an HTTP request, it parses the URL Path from the URL (immediately
following the hostname and port in the URL) and directs the request to the appropriate handler for
that HTTP share, which can be either a standard HTTP share, a file compatible mode API share,
or an object mode API share.
When listing StoreAll REST API-enabled shares through the Management Console, the RestApiMode
field indicates the share type and the URL Path field indicates the handler for a given HTTP request.
You can also obtain information about the RestAPIMode and URL Path, by entering the following
CLI command:
ibrix_httpshare -l
The following is displayed.
Component overview
The StoreAll REST API for the file-compatible mode has a number of components, such as custom
metadata assignments, metadata queries, and retention properties assignments.
File content transfer
You can upload and download files. You can also view the list of files and subdirectories of any
directory in the HTTP share, provided you have permission to navigate to that directory.
Custom metadata assignment
You can associate any number of custom (user-defined) metadata attributes to any file or directory
stored on a StoreAll retention-enabled file system where the Express Query metadata store is
enabled. Each custom attribute consists of an attribute name and assigned value. The API provides
commands to create custom metadata entries for a file, replace values of existing entries, and
delete entries.
Metadata queries
You can issue StoreAll REST API commands that query the pathname and custom and system
metadata attributes for a set of files and directories. Queries can be augmented with a search
criterion for a certain system or custom attribute; only files and directories that match the criterion
are included in the results. The query can specify a single file or a directory. If identifying a directory,
152 HTTP-REST API file-compatible mode shares