## 功能描述创建一个新的 TOS 桶。要创建存储桶，您必须注册火山引擎账号，并拥有一个有效的 TOS AccessKey ID 来验证请求。不允许匿名请求创建桶，并且一个用户在全局内最多可创建 100 个桶。通过创建桶，您就成为桶的所有者。 ## 存储类型在创桶时，您可以通过携带头域 `x-tos-storage-class` 来指定桶的默认存储类型。当前支持以下存储类型： * STANDARD（标准存储）：适用于频繁的数据访问，例如社交图片、热点视频、大数据分析等业务场景。 * IA（低频访问存储）：适用于不频繁访问（平均每月一到两次访问），例如数据备份、文件同步等业务场景。相较于标准存储，有较低的存储成本，但访问数据时会产生数据取回费用。关于计费详情，请参见[计费概述](/docs/6349/78455)。 * ARCHIVE_FR（归档闪回存储）：适用于基本不会被访问的数据，最少存储 90 天；支持直接读（闪回）和直接转换成其他存储类型。访问数据时会产生数据取回费用。关于计费详情，请参见[计费概述](/docs/6349/78455)。 * ARCHIVE（归档存储）：适用于基本不访问、需要长期保存数据的业务场景。最少需要存储 90 天；访问归档数据前需要先恢复数据。关于计费详情，请参见[计费概述](/docs/6349/78455)。 * COLD_ARCHIVE（冷归档存储）：属于冷数据类型，适用于极少访问、需要长期保存数据的业务场景。最少需要存储 180 天；访问冷归档数据前需要先恢复数据。关于计费详情，请参见[计费概述](/docs/6349/78455)。 * DEEP_COLD_ARCHIVE（深度冷归档存储）：适用于需要超长时间存放的极冷数据。最少需要存储 180 天；访问深度冷归档数据前需要先恢复数据。关于计费详情，请参见[计费概述](/docs/6349/78455)。 ## **请求消息样式** ```JSON 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`：冷归档存储。|\ | | | | | | :::tip|\ | | | | | | 当前仅华北2（北京）、华东2（上海）和华南1（广州）支持冷归档存储。|\ | | | | | | :::|\ | | | | | |* `DEEP_COLD_ARCHIVE`：深度冷归档存储。|\ | | | | | | :::tip|\ | | | | | | 当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该存储类型，请联系客户经理。|\ | | | | | ||\ | | | | | | :::| |x\-tos\-az\-redundancy |Header |String |否 |single\-az |桶的可用区冗余类型，取值说明如下：|\ | | | | | ||\ | | | | | |* `single-az`：单 AZ 冗余，默认值。|\ | | | | | |* `multi-az`：多 AZ 冗余。|\ | | | | | | :::tip|\ | | | | | | * 仅华北2（北京）、华东2（上海）、华南1（广州）和亚太东南（柔佛）地域支持多 AZ 冗余功能。详细说明，请参见[多 AZ 冗余](/docs/6349/158690)。|\ | | | | | | * 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`，表示开启保留策略，开启后不支持关闭。 | ## 请求元素该请求无请求消息元素。 ## 响应消息头返回公共的响应头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |Location |String |/bucketName |斜杠（/）和存储桶的名称。 | ## 响应元素该请求响应中无消息元素。 ## 请求示例 ```JSON 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 ``` ## 响应示例 ```JSON 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 ```

对象存储