HP StoreAll Storage - Manual (Page 179)

Delete custom metadata
This command removes one or more metadata attributes from an existing file or directory in the
HTTP share. Up to 15 metadata attributes may be removed in one command. The ability to delete
custom metadata is not currently constrained by WORM/retention settings.
The ability to delete custom metadata is not currently constrained by file permissions or the file's
WORM setting. If the file's directory is accessible to the API user, custom metadata operations are
allowed, regardless of file permissions or the WORM state of the file.
Deleting all custom metadata does not remove the protection from renames or moves. This protection
is independent of file WORM and retention states. If the file does not exist, no HTTP error status is
returned. A JSON error message is returned instead, as shown in the following example:
[
{ "physician" : "error in deleting"
]
If the file exists but any attributes being deleted do not exist, no HTTP error status is returned, and
the non-existent attributes are silently ignored.
The HTTP command is sent in the form of an HTTP DELETE request.
HTTP syntax
The HTTP request line format is the following on one line:
DELETE /<urlpath>[/<pathname>]?[version=1]attributes=<attribute1>
nl
[,<attribute2>…] HTTP/1.1
The equivalent curl command format is the following on one line:
curl -g –X DELETE
"http[s]://<IP_address>:<port>/<urlpath>[/<pathname>]?[version=1]
nl
attributes=<attribute1>[,<attribute2>…"]
See “Using HTTP” (page 108) for information about the IP address, port, and URL path.
Description Parameter
The name of the existing file/directory on the HTTP share for which custom metadata is
to be deleted. pathname
Directory pathnames must end in a trailing slash /.
The existing name(s) for the custom metadata attribute(s) to be deleted from the file or
directory custom metadata list. attribute[n]
Example
curl -g –X DELETE "http://99.226.50.92/ibrix_share1/lab/images/xyz.jpg?
attributes=physician,scan_pass"
This example deletes two custom metadata attributes from an existing file called xyz.jpg in the
lab/images
subdirectory on the ibrix_share1 HTTP share. The first attribute to delete is
physician and the second is scan_pass.
Metadata queries
The API provides a command to query the metadata about a file or directory on an IBRIX HTTP
share. The command defines the file or directory to query, the metadata fields to return, and how
to filter the list of files and directories returned based on metadata criteria. All queries are performed
on the Express Query database, requiring no other file system access or scans.
The HTTP command is sent in the form of an HTTP GET request.
StoreAll REST API 179