All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

HEAD Bucket

Last updated:2021-09-14 16:17:59

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

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.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
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback