HEAD Bucket

最近更新时间:2020-02-17 15:22:25

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:

Request parameters

The interface does not use request parameters.

Request header

This interface only uses common request headers. For more information, please click Common 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 Common 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 low-frequency storage; the 'ARCHIVE' is an archive type, which can only upload archive files. Name Description
x-kss-bucket-type Used to describe bucket type.
Type:String
Default value:NORMAL
Valid value:NORMAL ARCHIVE

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.ksyun.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

金山云,开启您的云计算之旅

注册有礼