S3 Bucket Operations:Head Bucket

Search (SHIFT+S)

Head Bucket


Determines if the bucket exists and if the user has permission to access it.

URL Format

Host Style: http://bucketname.ns1.emc.com/
Path Style: http://ns1.emc.com/bucketname

Request Headers

x-amz-date optionalThe timestamp of the request added by the requester. Example: Tue, 03 Sept 2013 12:00:00 GMT. If the Authorization header is specified, you must specify either the x-amz-date or the Date header. If both the headers are specified, the value of x-amz-date header is chosen.
Authorization requiredInformation needed to authenticate requests.


The following conditions must be met in order to call this operation.

  • Only the user that has permission to access this bucket can send this request.

  • BaseUrl used in a host-style URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketrname.ns1.emc.com).

  • Namespace corresponding to this bucket should exist (for example, ns1).

Request Payload

No Request Payload

Response Headers

x-amz-request-id optionalRequest id.
x-amz-id-2 optionalBucket identifier.
x-emc-retention-period optionalBucket retention period.

Response Body

Response indicating Success or Failure for this operation.