全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

Head Bucket

最近更新时间: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存储类型。

  • 类型:String

  • 默认值:NORMAL

  • 有效值:NORMAL、IA、ARCHIVE

x-kss-bucket-visit-type

Bucket访问类型。

  • 类型:String

  • 默认值:NORMAL

  • 有效值:NORMAL、FREQUENTLIST

响应内容

该接口不返回响应内容。

特殊错误

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

示例

请求示例

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的权限。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈