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

CreateBucket

最近更新时间：2024.03.26 20:37:27

首次发布时间：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-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：低频访问存储。
  • ARCHIVE_FR：归档闪回存储。
  • ARCHIVE：归档存储。
  • COLD_ARCHIVE：冷归档存储。

    说明

    当前仅华北2（北京）和华东2（上海）支持冷归档存储类型。

  • DEEP_COLD_ARCHIVE：深度冷归档存储。

    说明

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

x-tos-az-redundancy

Header

String

否

single-az

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

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

    说明

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

x-tos-project-name

Header

String

否

default

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

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

请求元素

该请求无请求消息元素。

响应消息头

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

名称

参数类型

说明

Location

String

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

响应元素

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

请求示例

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