最近更新时间:2024-08-30 16:19:43
此 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存储类型。
|
x-kss-bucket-visit-type | Bucket访问类型。
|
该接口不返回响应内容。
该接口不返回任何特殊错误。
请求示例
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
x-kss-bucket-visit-type: NORMAL
Server: KS3
错误码 | HTTP状态码 | 描述 |
---|---|---|
NoSuchBucket | 404 Not Found | 该Bucket不存在。 |
Access Denied | 403 Forbidden | 没有访问该Bucket的权限。 |
纯净模式