You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

HeadBucket

最近更新时间：2024.01.15 15:20:41

首次发布时间：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

桶所在地域。

x-tos-storage-class

String

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

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

    说明

    深度冷归档目前处于邀测状态，如您需要使用该存储类型，请联系客户经理。

x-tos-az-redundancy

String

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

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

    说明

    多 AZ 冗余功能目前处于邀测状态，如您需要使用该功能，请联系客户经理。详细说明，请参见多 AZ 冗余。

响应元素

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

请求示例

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