1. Oracle ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.x
  2. S3 Object API Operation Command Reference
  3. Operations on Buckets
  4. HEAD Bucket

HEAD Bucket

The HEAD Bucket operation determines whether a bucket exists and if you have permission to access it. To use this operation, you must have permissions to list content in the share target.

Syntax Example

HEAD https://appliance:443/s3/v1/export/share_mount_point_path/bucketname

Request Parameters

The HEAD Bucket operation does not support the use of request parameters.

Request Headers

The HEAD Bucket operation uses only request headers that are common to all operations. For more information, see table "Common Supported Request Headers" in Supported Common Request Headers.

Request Elements

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

Response Headers

The HEAD Bucket operation uses only response headers that are common to most responses. For more information, see table "Supported Response Headers" in Supported Common Response Headers.

Response Elements

The HEAD Bucket operation does not support the use of response elements.

Normal Response Code

200 OK

Note:

The HEAD Bucket operation returns the 200 OK response code when both the bucket and access permissions to the bucket exist.

Error Response Codes

  • 404 Not Found. This response code is returned when the bucket does not exist.

  • 403 Forbidden. This response code is returned when permissions to access the bucket do not exist.

For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

HEAD /
HTTP/1.1 200 OK
x-amz-request-id: tx32FE2CEB32F5EE25
Date: Fri, 10 2018 21:34:56 GMT
Server: Apache