HEAD Bucket¶
The HEAD Bucket operation is used to determine whether a bucket exists and can be accessed.
HEAD Bucket returns 200 OK
if the bucket is in the system and
accessible, otherwise the operation can return such responses as
404 Not Found
or 403 Forbidden
.
Requests¶
Syntax¶
HEAD / HTTP/1.1
Host: {{BucketName}}.{{StorageService}}.com
Date: {{date}}
Authorization: {{authorizationString}}
Parameters¶
The HEAD Bucket operation does not use request parameters.
Headers¶
The HEAD Bucket operation uses only request headers that are common to all operations (refer to Common Request Headers).
Elements¶
The HEAD Bucket operation does not use request elements.
Responses¶
Headers¶
The HEAD Bucket operation uses only response headers that are common to all operations (refer to Common Response Headers).
Elements¶
The HEAD Bucket operation does not return response elements.
Examples¶
Determining the Status of a Particular Bucket¶
Request¶
HEAD / HTTP/1.1
Date: Fri, 10 Feb 2012 21:34:55 GMT
Authorization: {{authorizationString}}
Host: {{bucketname}}.s3.example.com
Connection: Keep-Alive
Response¶
HTTP/1.1 200 OK
x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80
x-amz-request-id: 32FE2CEB32F5EE25
Date: Fri, 10 2012 21:34:56 GMT
Server: ScalityS3