最近更新时间: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的权限。 |
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!