PowerScale OneFS API Reference

PDF

Get the contents of a file

Retrieves the contents of a file from a specified path.

Request syntax

GET /namespace/<access_point>/<file_path> HTTP/1.1
Host <hostname>[:<port>]
Date: <date>
Authorization: <signature>
Range: bytes=<byte_range>

Request query parameters

There are no query parameters for this request.

Request headers


Header Name	Description	Default	Type	Required
Range	Returns the specified range bytes of an object. Only the basic range is supported. The format is defined as: first-byte-pos "-" last-byte-pos The first-byte-pos value in a byte-range-spec gives the byte-offset of the first byte in a range. The last-byte-pos value gives the byte-offset of the last byte in the range; that is, the byte positions that are specified are inclusive. Byte offsets start at zero.	None	String	No
If-Modified-Since	Returns only files that were modified since the specified time. If no files were modified since this time, a 304 message is returned.	None	HTTP date	No
If-Unmodified-Since	Returns only files that were not modified since the specified time. If there are no unmodified files since this time, a 412 message is returned to indicate that the precondition failed.	None	HTTP date	No

Response headers


Header Name	Description
Content-Encoding	Provides the content encoding that was applied to the object content, so that decoding can be applied when retrieving the content.
Content-Type	Provides a standard MIME-type description of the content format.
x-isi-ifs-attr-<attr_name>	Provides the extended attributes that were set in the message header when the file was created.
x-isi-ifs-missing-attr	Provides the number of attributes that cannot be displayed in the HTTP header.
x-isi-ifs-access-control	Provides the access mode for the file in octal number format.

Response body

No message body is returned upon success.

Example request

GET /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
Content-Length: 54380
Content-Type: image/jpeg
Connection: close
Server: Apache2/2.2.19

[54380 bytes of data]