PowerScale OneFS API Reference

PDF

Get the attributes for a file with the HEAD method

Retrieves the attribute information for a specified file. Attributes are returned as headers only if they can be displayed.

Request syntax

HEAD /namespace/<access_point>/<file_path> HTTP/1.1
Host <hostname>[:<port>]
Date: <date>
Authorization: <signature>

Request query parameters

There are no query parameters for this request.

Request headers


Header Name	Description	Default	Type	Required
If-Modified-Since	Returns only file content that was modified since the specified time. If no file content was modified, a 304 message is returned.	None	HTTP date	No
If-Unmodified-Since	Returns only file content that was not modified since the specified time. If there is no unmodified file content, a 412 message is returned to indicate that the precondition failed.	None	HTTP date	No

Response headers


Header Name	Description	Default	Type	Required
Content-Encoding	Provides the content encoding that was applied to the object content, so that decoding can be applied when retrieving the content.	None	String	No
Content-Type	Provides a standard MIME-type description of the content format.	binary/octet-stream	String	No
x-isi-ifs-attr-<attr_name>	Provides the extended attributes that were set in the message header.	None	String	No
x-isi-ifs-missing-attr	Provides the number of attributes that cannot be displayed in the HTTP header. The missing attributes can be retrieved through the operation: GET extended attributes of a file operation.	None	Integer	No
x-isi-ifs-access-control	Provides a predefined ACL value or POSIX mode with a string, such as private, private_read, public_read, public_read_write, or public.	0700	String	No

Response body

No message body is returned upon success.

Example request

HEAD /namespace/ifs/my_folder/picture.jpg HTTP/1.1
Host my_cluster:8080
Date: Thu Sep 22 16:06:32 GMT 2011
Authorization: <signature>

Example response

HTTP/1.1 200 OK
Date:  Thu Sep 22 16:06:32 GMT 2011
Server:  Apache/2.2.21 (FreeBSD) mod_ssl/2.2.21 OpenSSL/0.9.8x mod_webkit2/1.0 mod_fastcgi/2.4.6
Allow:  DELETE, GET, HEAD, POST, PUT
Last-Modified:  Wed, 20 Mar 2013 18:16:17 GMT
x-isi-ifs-access-control:  0600
x-isi-ifs-attr-color:  red
x-isi-ifs-missing-attr:  1
x-isi-ifs-spec-version:  1.0
x-isi-ifs-target-type:  object