对象存储 HeadBucket

HeadBucket 接口请求用于确认存储桶是否存在以及调用方是否有权限访问，返回结果以 HTTP 状态码及响应头部呈现，无响应体。
注意事项
存储桶存在且调用方有访问权限：返回 200 OK。
调用方对该存储桶无访问权限：返回 403 Forbidden。
存储桶不存在：返回 404 Not Found。
请求
请求语法
HEAD / HTTP/1.1
Host: <BucketName>-x--<APPID>.cosrapid.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明：
Authorization 字段的具体格式见 公共请求头部。
请求参数
此接口无请求参数。
请求头部
此接口仅使用 公共请求头部，无私有请求头部。
请求体
该请求的请求体为空。
响应
响应头部
除 公共响应头部 外，请求成功时本接口还返回以下私有响应头部：
名称
描述
类型
x-cos-bucket-status
存储桶状态，取值为 Creating、Available、Deleting，分别表示存储桶处于创建中、可用、删除中
Enum
x-cos-fusionfs-id
存储桶关联的 CFS Turbo 文件系统 ID
string
x-cos-owner-uin
存储桶持有者主账号 UIN
string
x-cos-vpc-id
存储桶绑定的 VPC ID
string
x-cos-subnet-id
存储桶绑定的子网 ID
string
x-cos-zone
存储桶所在可用区，例如 ap-guangzhou-3
string
x-cos-creation-date
存储桶的创建时间，ISO 8601 格式（RFC3339），例如 2023-10-13T09:13:10Z
date
响应体
该响应体为空。
错误码
本接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。
实际案例
请求
HEAD / HTTP/1.1
Host: examplebucket-x--1250000000.cosrapid.ap-guangzhou.myqcloud.com
Date: Fri, 13 Oct 2023 09:13:10 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDXXXXXXXX&q-sign-time=1484813288;32557709288&q-key-time=1484813288;32557709288&q-header-list=date;host&q-url-param-list=&q-signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
响应
HTTP/1.1 200 OK
Content-Length: 0
Date: Fri, 13 Oct 2023 09:13:10 GMT
x-cos-request-id: NjUwMDAwMDAwMDAwMDAwMDAw
x-cos-bucket-status: Available
x-cos-fusionfs-id: fsxxxxxxx
x-cos-owner-uin: 100000000001
x-cos-vpc-id: vpc-abcdefgh
x-cos-subnet-id: subnet-abcdefgh
x-cos-zone: ap-guangzhou-3
x-cos-creation-date: 2023-10-13T09:13:10Z

名称	描述	类型
x-cos-bucket-status	存储桶状态，取值为 `Creating`、`Available`、`Deleting`，分别表示存储桶处于创建中、可用、删除中	Enum
x-cos-fusionfs-id	存储桶关联的 CFS Turbo 文件系统 ID	string
x-cos-owner-uin	存储桶持有者主账号 UIN	string
x-cos-vpc-id	存储桶绑定的 VPC ID	string
x-cos-subnet-id	存储桶绑定的子网 ID	string
x-cos-zone	存储桶所在可用区，例如 `ap-guangzhou-3`	string
x-cos-creation-date	存储桶的创建时间，ISO 8601 格式（RFC3339），例如 `2023-10-13T09:13:10Z`	date

HeadBucket

本页目录：

注意事项

请求

请求语法

请求参数

请求头部

请求体

响应

响应头部

响应体

错误码

实际案例

请求

响应