功能描述

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

存储类型

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

STANDARD（标准存储）：适用于频繁的数据访问，例如社交图片、热点视频、大数据分析等业务场景。

IA（低频访问存储）：适用于不频繁访问（平均每月一到两次访问），例如数据备份、文件同步等业务场景。相较于标准存储，有较低的存储成本，但访问数据时会产生数据取回费用。

INTELLIGENT_TIERING（智能分层存储）：适用于不确定当前对象的访问频率的数据，TOS 会自动监控智能分层对象的访问次数，并根据智能分层规则，将对象转换为低频访问层或归档闪回访问层。

ARCHIVE_FR（归档闪回存储）：适用于基本不会被访问的数据，最少存储 90 天；支持直接读（闪回）和直接转换成其他存储类型。访问数据时会产生数据取回费用。

ARCHIVE（归档存储）：适用于基本不访问、需要长期保存数据的业务场景。最少需要存储 90 天；访问归档数据前需要先恢复数据。

COLD_ARCHIVE（冷归档存储）：属于冷数据类型，适用于极少访问、需要长期保存数据的业务场景。最少需要存储 180 天；访问冷归档数据前需要先恢复数据。

DEEP_COLD_ARCHIVE（深度冷归档存储）：适用于需要超长时间存放的极冷数据。最少需要存储 180 天；访问深度冷归档数据前需要先恢复数据。

关于计费详情，请参见计费概述。

请求消息样式

请求参数和消息头

名称	位置	参数类型	是否必选	示例值	说明
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（广州）支持冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。说明当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该存储类型，请联系客户经理。
x-tos-az-redundancy	Header	String	否	single-az	桶的可用区冗余类型，取值说明如下： single-az：单 AZ 冗余，默认值。 multi-az：多 AZ 冗余。说明仅华北2（北京）、华东2（上海）、华南1（广州）和亚太东南（柔佛）地域支持多 AZ 冗余功能。详细说明，请参见多 AZ 冗余。 HNS 桶的多 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 桶。
x-tos-bucket-object-lock-enabled	Header	String	否	true	是否开启保留策略功能，仅支持取值 true，表示开启保留策略，开启后不支持关闭。

请求元素

该请求无请求消息元素。

响应消息头

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

名称	参数类型	示例值	说明
Location	String	/bucketName	斜杠（/）和存储桶的名称。

响应元素

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

请求示例

响应示例

对象存储