HEAD Bucket

Description

This HEAD operation is used to determine whether a user space exists and the permissions that the user has to operate it. If the specified space exists and the user has permission to access it, KS3 will return '200 OK'. Otherwise, an error of '404 Not Found' or '403 Forbidden' will be returned.

Request

Grammar

HEAD / HTTP/1.1   
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

Note:

• Corresponding relationship between Endpoint and Region
• SignatureValue signature algorithm

Request parameters

The interface does not use request parameters.

Request header

This interface only uses common request headers. For more information, please click Public request headers.

Request content

The interface does not use the requested content.

Response

Response header

This interface can use all common response headers. For more information, please click Public response headers.

In addition to the common response headers, the x-kss-bucket-type response header is returned, indicating the Bucket type. The NORMAL is a non archive type, which can upload standard storage and infrequent access storage; the ARCHIVE is an archive type, which can only upload archive files.

Response content

The interface does not return the corresponding content.

Special errors

The interface does not return any special errors.

Example

Request example

HEAD / HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 01 Mar 2006 12:00:00 GMT
Authorization: authorization string
Connection: Keep-Alive

Response example

HTTP/1.1 200 OK
Date: Fri, 10 2012 21:34:56 GMT
Server: KS3
x-kss-bucket-type: NORMAL