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

HTTP syntax
The HTTP request line format is:
DELETE /<urlpath>/<pathname> HTTP/1.1
The equivalent curl command format is:
curl -X DELETE http[s]://<IP_address>:<port>/<urlpath>/<pathname>
See “Using HTTP” (page 114) for information about the IP address, port, and URL path.
DescriptionParameter
The pathname of the existing file on the HTTP share to be deleted.pathname
Example
curl -X DELETE http://99.226.50.92/ibrix_share1/lab/images/xyz.jpg
This example deletes the existing file called xyz.jpg in the lab/images subdirectory on the
ibrix_share1 HTTP share.
Custom metadata assignment
The API provides commands to define a custom metadata attribute for an existing file or directory
in an HTTP share and to delete an existing custom metadata attribute.
For information about retrieving or querying existing custom metadata already applied to files,
see “Metadata queries” (page 152).
Upload custom metadata (add or replace)
This command adds or modifies one or more custom metadata attributes for an existing file or
directory on the HTTP share. If the specified attribute does not exist for the file, it is added to the
custom metadata list for that file or directory. If an attribute already exists, the current value is
replaced with the client’s value.
Custom metadata applied to a directory does not also apply to files or directories in that directory,
only to the directory itself.
Up to 15 metadata attributes can be assigned in one command. However, there is no defined limit
on the number of metadata attributes that can be assigned to a file. To assign more than 15
attributes, send multiple PUT requests for the same file.
The ability to add or replace custom metadata depends on the permissions of the directory and
file being updated. The custom metadata can be changed if the user has permission to navigate
to the directory containing the file (depending on the “x” permission bits of the directory and all
of its parents) and the user has read permission on the file.
NOTE: The file's write permission is ignored. This behavior will be corrected in a future release
so that the file's write permission is checked instead of its read permission.
Although attributes and values may be up to 80 characters each, HTTP request messages have a
practical limit of about 2000 bytes which supersedes these maximums.
When custom metadata is added, the file or directory becomes protected from renames or moves
and such actions will be denied, even if all custom metadata is later removed. This protection is
independent of file WORM and retention states.
If the file does not exist, a "500 (Internal Server Error)" HTTP error is returned (not a "404 Not
Found").
The HTTP command is sent in the form of an HTTP PUT request.
158 HTTP-REST API file-compatible mode shares