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

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. For more details about this operation, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Request Elements

• Response Headers

• Response Elements

• Normal Response Code

• Error Response Codes

• Example

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 Figure 7, Table 7, Common Supported 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 Figure 9, Table 9, Supported Response Headers .

Response Elements

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

Normal Response Code

200 OK

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