金山云-文档中心-Head Bucket

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Bucket相关

基本操作

Head Bucket

最近更新时间：2025-05-29 17:43:57



描述

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

请求

请求语法

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

1. Endpoint与Region对应关系。

2. SignatureValue签名算法。

请求参数

该接口不使用请求参数。

请求头部

该接口只使用常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头部

该接口除返回公共响应头部外，还返回以下响应头：

名称	描述
x-kss-bucket-type	Bucket存储类型。类型：String 默认值：NORMAL 有效值：NORMAL、IA、ARCHIVE NORMAL表示标准存储类型，IA表示低频存储类型，ARCHIVE表示归档存储类型。
x-kss-bucket-visit-type	Bucket访问类型。类型：String 默认值：NORMAL 有效值：NORMAL、FREQUENTLIST 1. NORMAL表示标准类型Bucket，该桶类型适合源站等对数据频繁访问的场景。 2. FREQUENTLIST表示高频枚举类型Bucket，该桶类型适合AI训练、数据清洗等对GET Bucket（LIST Objects）请求较多的场景。
x-kss-data-redundancy-type	Bucket的冗余类型。有效值：LRS、ZRS，LRS表示同城冗余，ZRS表示本地冗余
x-kss-ZRS-switch-enable	同城冗余开关的开启状态。有效值：true、false，true表示开启同城冗余开关，false表示关闭同城冗余开关

响应内容

该接口不返回响应内容。

特殊错误

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

示例

请求示例

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
x-kss-data-redundancy-type: LRS
Server: KS3

错误码

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

文档导读

上一篇：GET Bucket Location

下一篇：List Objects V2

纯净模式常规模式

纯净模式

点击可全屏预览文档内容