You need to enable JavaScript to run this app.
导航

CreateBucket

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

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

请求元素

该请求无请求消息元素。

响应消息头

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

名称

参数类型

说明

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