Head Bucket

最近更新时间:2023-01-03 15:36:23

描述

此 HEAD 操作用于判断某一存储空间是否存在,以及用户所拥有的操作它的权限。如果指定存储空间存在且用户拥有访问它的权限,KS3将返回 200 OK

请求

语法

HEAD / HTTP/1.1   
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {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

错误码

错误码 HTTP状态码 描述
NoSuchBucket 404 Not Found 该Bucket不存在。
Access Denied 403 Forbidden 没有访问该Bucket的权限。

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈