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

功能描述

创建一个新的 TOS 桶。要创建存储桶，您必须注册火山引擎账号，并拥有一个有效的 TOS AccessKey ID 来验证请求。不允许匿名请求创建桶，并且一个用户在全局内最多可创建 100 个桶。通过创建桶，您就成为桶的所有者。

存储类型

在创桶时，您可以通过携带头域 x-tos-storage-class 来指定桶的默认存储类型。当前支持以下存储类型：

  • STANDARD（标准存储）：适用于频繁的数据访问，例如社交图片、热点视频、大数据分析等业务场景。
  • IA（低频访问存储）：适用于不频繁访问（平均每月一到两次访问），例如数据备份、文件同步等业务场景。相较于标准存储，有较低的存储成本，但访问数据时会产生数据取回费用。关于计费详情，请参见计费概述。
  • ARCHIVE_FR（归档闪回存储）：适用于基本不会被访问的数据，最少存储 90 天；支持直接读（闪回）和直接转换成其他存储类型。访问数据时会产生数据取回费用。关于计费详情，请参见计费概述。
  • ARCHIVE（归档存储）：适用于基本不访问、需要长期保存数据的业务场景。最少需要存储 90 天；访问归档数据前需要先恢复数据。关于计费详情，请参见计费概述。
  • COLD_ARCHIVE（冷归档存储）：属于冷数据类型，适用于极少访问、需要长期保存数据的业务场景。最少需要存储 180 天；访问冷归档数据前需要先恢复数据。关于计费详情，请参见计费概述。
  • DEEP_COLD_ARCHIVE（深度冷归档存储）：适用于需要超长时间存放的极冷数据。最少需要存储 180 天；访问深度冷归档数据前需要先恢复数据。关于计费详情，请参见计费概述。

请求消息样式

PUT / HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Authorization: authorization string
Date: Fri, 30 Jul 2021 06:45:39 GMT
x-tos-acl: ACL
x-tos-grant-full-control: GrantFullControl
x-tos-grant-read: GrantRead
x-tos-grant-read-acp: GrantReadACP
x-tos-grant-write: GrantWrite
x-tos-grant-write-acp: GrantWriteACP
x-tos-storage-class: STANDARD
x-tos-tagging: key1=value1&key2=value2

请求参数和消息头

名称

位置

参数类型

是否必选

示例值

说明

x-tos-acl

Header

String

否

private

桶访问权限，有效的权限设置包括：

  • private：私有的，默认值。
  • public-read：公共读。
  • public-read-write：公共读写。
  • authenticated-read：认证用户读。
  • bucket-owner-read：桶所有者读。
  • bucket-owner-full-control：桶所有者完全权限。

x-tos-grant-full-control

Header

String

否

id=123

对桶具有读（READ）、写（WRITE）、读（READ） ACP、写（WRITE） ACP的权限。
格式：id=账号1,id=账号2。

x-tos-grant-read

Header

String

否

id=123

允许被授权者列举桶内对象。
格式：id=账号1,id=账号2。

x-tos-grant-read-acp

Header

String

否

id=123,id=456

允许被授权者读取桶 ACL。
格式：id=账号1,id=账号2。

x-tos-grant-write

Header

String

否

id=123,id=456

允许被授权者在桶中创建新对象。对于现有对象的桶和对象所有者，允许删除和覆盖这些对象。
格式：id=账号1,id=账号2。

x-tos-grant-write-acp

Header

String

否

id=123,id=456

允许被授权者写ACP权限。
格式：id=账号1,id=账号2。

x-tos-storage-class

Header

String

否

STANDARD

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

  • STANDARD：标准存储，默认值。
  • IA：低频访问存储。
  • INTELLIGENT_TIERING：智能分层存储
  • ARCHIVE_FR：归档闪回存储。
  • ARCHIVE：归档存储。
  • COLD_ARCHIVE：冷归档存储。

    说明

    当前华北2（北京）和华东2（上海）默认支持冷归档存储，华南1（广州）处于邀测状态，如您需要在华南1（广州）使用冷归档存储，请联系客户经理。

  • DEEP_COLD_ARCHIVE：深度冷归档存储。

    说明

    当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该存储类型，请联系客户经理。

x-tos-az-redundancy

Header

String

否

single-az

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

  • single-az：单 AZ 冗余，默认值。
  • multi-az：多 AZ 冗余。

    说明

    仅华北2（北京）和华东2（上海）地域支持多 AZ 冗余功能。详细说明，请参见多 AZ 冗余。

x-tos-project-name

Header

String

否

default

桶关联的项目名称，取值说明如下：

  • 如果在请求中携带该请求头并指定项目名称，则创建的桶属于该项目。
  • 当指定的项目名称为default时，则创建的桶属于默认项目。
  • 如果在请求中未携带该请求头，则创建的桶属于默认项目。

x-tos-tagging

Header

String

否

key1=value1&key2=value2

设置存储桶的标签信息， 格式为 {Key}={Value}，支持同时设置多个标签，设置多个标签时使用 & 分隔。每个存储桶最多可绑定 50 个标签。标签键和标签值的约束限制如下：

  • 标签键
    • 长度限制在1～128个字符之间。
    • 支持任何语言字母或文字（例如中文、英文字母等）、数字、空格；支持特殊字符：_.:/+-@。
    • 不能以任何大小写形式的volc:开头，volc:开头为系统预留标签键，禁止创建。
  • 标签值
    • 长度限制在 0~256 个字符之间，标签值可以为空。
    • 支持任何语言字母或文字（例如中文、英文字母等）、数字、空格；支持特殊字符：_.:/+-@。

x-tos-bucket-type

Header

String

否

hns

  • 设置桶的类型，参数类型 string，非必选参数，取值说明如下：

    • fns：扁平桶。

    • hns：分层桶。

      不携带此消息头则默认创建 fns 桶。

请求元素

该请求无请求消息元素。

响应消息头

返回公共的响应头，请参见公共参数。

名称

参数类型

示例值

说明

Location

String

/bucketName

斜杠（/）和存储桶的名称。

响应元素

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

请求示例

PUT / HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
x-tos-acl: ACL
Content-Length: 0
Date: Fri, 30 Jul 2021 06:45:39 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
x-tos-id-2: f91b0c03a01300c1-a444ed0        
x-tos-request-id: f91b0c03a01300c1-a444ed0            
Date: Fri, 30 Jul 2021 06:45:39 GMT
Location: /bucketName  
server: TosServer
Content-Length: 0