HEAD Bucket

描述

此 HEAD 操作用于判断某一存储空间是否存在，以及用户所拥有的操作它的权限。如果指定存储空间存在且用户拥有访问它的权限，KS3将返回 200 OK。否则，将会返回 404 Not Found 或 403 Forbidden 错误。

请求

语法

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

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

请求参数

该接口不使用请求参数。

请求头部

该接口只使用常用请求头部。获取更多信息，请点击常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头部

该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。

除常用响应头部外，还返回x-kss-bucket-type响应头，表示Bucket的类型，NORMAL为非归档类型，ARCHIVE为归档类型。

名称	描述
x-kss-bucket-type	用于说明Bucket类型。 类型：String 默认值：NORMAL 有效值：NORMAL ARCHIVE

响应内容

该接口不返回相应内容。

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

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

响应示例

HTTP/1.1 200 OK
Date: Wed, 01 Mar 2006 12:01:00 GMT
Connection: keep-alive
x-kss-request-id: f86t0t80lcrobs7c05ib5no5ln32eh8l
x-kss-bucket-type: NORMAL
Server: KS3