Go to main content

Oracle® ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.0

Exit Print View

Updated: January 2019
 
 

HEAD Object

The HEAD Object operation retrieves metadata from an object without returning the object itself. This operation is useful if you are interested only in an object's metadata. To use this operation, you must have READ access to the object. A HEAD request has the same options as a GET operation on an object. The response is identical to the GET response except that there is no response body. For more details about the Head Object operation, see the following:

Syntax Example

HEAD https://<appliance>:443/s3/v1/export/<share_mount_point_path>/<bucketname>/<objectname>

Request Parameters

This implementation of the HEAD Object operation does not support the use of request parameters.

Request Headers

The HEAD Object operation supports the use of the following type of request headers:

Request Elements

The HEAD Object operation does not support the use of request elements.

Response Headers

This implementation of the HEAD Object operation supports the use of the x-amz-meta-* and the x-amz-version-id response headers. For more details about these response headers, see Amazon's official S3 HEAD Object API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html).

Response Elements

This implementation of the HEAD Object operation does not return response elements.

Expected HTTP Response Code

200 OK

Error Response Code

The HEAD Object API does not return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

HEAD /my-image.jpg
HTTP/1.1 200 OK
x-amz-request-id: 318BC8BC143432E5
x-amz-version-id: 0007
x=custom-made: custom-value
Date: Wed, 28 Oct 2018 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2018 12:00:00 GMT
ETag: "fba9dede5f27731c9771645a39863328"
Content-Length: 434234
Content-Type: text/plain
Connection: close
Server: Apache