Delete a file, File system flush, Delete a file file system flush – HP StoreAll Storage User Manual

Page 223

Advertising
background image

This example downloads an existing file called xyz.jpg in the lab/images subdirectory of the
ibrix_share1

HTTP share. The file is created with the filename a1.jpg on the client system, in

the subdirectory temp of the user’s current directory.

If the file already exists at that path on the client, its contents are overwritten by the contents of
xyz.jpg

, provided that the local client’s permissions and retention settings on that file and directory

allow it. If the overwriting is denied, a local client system-specific error message is returned.

Delete a file

This command removes a file from the StoreAll file system by using the HTTP share interface. File
deletion is subject to StoreAll permissions on the file and directory, and it is subject to retention
settings on that file system. If file deletion is denied, an HTTP error is returned. If the file does not
exist, a 404 Not Found HTTP error is returned.

NOTE:

The delete command is only for WebDAV enabled shares.

The HTTP command is sent in the form of an HTTP DELETE request.

HTTP syntax

The HTTP request line format is:

DELETE /<urlpath>/<pathname> HTTP/1.1

[Sync-Requested: 1]

The equivalent curl command format is:

curl -X DELETE http[s]://<IP_address>:<port>/<urlpath>/<pathname>

--header [Sync-Requested: 1]

The optional "Sync-Requested: 1" header is about durability. After the requested change has been
made to the file, a sync is done to ensure that the change has been made durably on disk before
the HTTP response is sent to the user. Note that this operation will wait all buffers be flushed to the
disks before return back the operation result. If this header is requested, the HTTP response will
return a header "Sync-Result" header. The value which follows that key represent the errno value,
where 0 (zero) means that sync was done successfully and any other value indicates sync does
not complete and durability is not guaranteed.

See

“Using HTTP” (page 174)

for information about the IP address, port, and URL path.

Description

Parameter

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.

File system flush

Sync or flush all pending write operations on the entire file system. This is a special case of file
upload because it is a PUT request in the HTTP share url path only.

HTTP syntax

The HTTP request line format is:

The HTTP request line format is: PUT /<urlpath>/ HTTP/1.1

Sync-Requested: 1

The equivalent curl command format entered on one line is:

File content transfer 223

Advertising