You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/API 参考/存储桶/桶基础操作/HeadBucket
HeadBucket
最近更新时间：2025.02.25 21:15:51首次发布时间：2021.10.13 16:14:07
我的收藏
有用
有用
无用
无用

功能描述

此接口用于判断桶是否存在和是否有桶的访问权限。
如果具有桶的访问权限并且桶存在，则返回 200 OK 状态码。如果桶不存在或者没有访问桶的权限，此 HEAD 请求会返回 404 Not Found 或 403 Forbidden 状态码。

请求消息样式

HEAD / HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

名称

参数类型

示例值

说明

x-tos-bucket-region

String

cn-beijing

桶所在地域。

x-tos-storage-class

String

STANDARD

桶的默认存储类型，取值说明如下：

  • STANDARD：标准存储。
  • IA：低频访问存储。
  • INTELLIGENT_TIERING：智能分层存储
  • ARCHIVE_FR：归档闪回存储。
  • ARCHIVE：归档存储。
  • COLD_ARCHIVE：冷归档存储。
  • DEEP_COLD_ARCHIVE：深度冷归档存储。

x-tos-project-name

String

default

桶关联的项目名称。

x-tos-az-redundancy

String

multi-az

桶的可用区冗余类型，取值说明如下：

  • single-az：单 AZ 冗余。
  • multi-az：多 AZ 冗余。

x-tos-bucket-type

String

hns

桶的类型，取值说明如下：

  • 未返回此响应消息头：扁平桶。
  • hns：分层桶。

响应元素

该请求响应中无消息元素。

请求示例

HEAD / HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2021 08:05:36 GMT
Server: TosServer
x-tos-id-2: d242440bbb9b000e-a444ed0
x-tos-request-id: d242440bbb9b000e-a444ed0
x-tos-bucket-region: cn-beijing
x-tos-storage-class: STANDARD
x-tos-project-name: default