更新时间:2024-01-02 GMT+08:00

创建桶

功能介绍

创建桶是指按照用户指定的桶名创建一个新桶的操作。

  • 默认情况下,一个用户可以拥有的桶的数量不能超过100个。
  • 用户删除桶后,需要等待30分钟才能创建同名桶和并行文件系统。
  • OBS支持在创建桶时打开桶级WORM开关,打开后可以为桶内的对象设置WORM,详见配置桶级默认WORM策略。注意:WORM开关只能在创建桶时打开,一旦打开无法关闭;在打开WORM开关的时候会默认为桶开启多版本,且多版本状态无法关闭;您无法为一个桶同时开启WORM开关和并行文件系统。

新创建桶的桶名在OBS中必须是唯一的。如果是同一个用户重复创建同一区域的同名桶时返回成功。除此以外的其他场景重复创建同名桶返回桶已存在。用户可以在请求消息头中加入x-obs-acl等参数,设置要创建桶的权限控制策略。

存储类型

允许用户创建不同默认存储类型的桶。发送创桶请求时携带头域“x-obs-storage-class”来指定桶的默认存储类型。桶内对象的存储类型与桶默认存储类型保持一致。存储类型有3种:STANDARD(标准存储)、WARM(温存储)、COLD(冷存储)。如果没有携带此头域 ,则创建的桶为标准存储类型。

当往桶内上传对象时,如果没有指定对象的存储类别(参考PUT上传),则该对象的存储类型取桶的默认存储类型。

  • OBS标准存储拥有低访问时延和较高的吞吐量,因而适用于有大量热点文件需要频繁访问数据的业务场景,例如:大数据、移动应用、热点视频、社交图片等场景。
  • OBS温存储适用于不频繁访问(少于每月一次访问)但在需要时也要求快速访问数据的业务场景,例如:文件同步/共享、企业备份等场景。与标准存储相比,温存储有相同的数据持久性、吞吐量以及访问时延,且成本较低,但是可用性略低于标准存储。
  • OBS冷存储适用于很少访问(平均一年访问一次)数据的业务场景,例如:数据归档、长期备份等场景。冷存储安全、持久且成本极低,可以用来替代磁带库。为了保持成本低廉,数据恢复时间可能长达数分钟到数小时不等。

请求消息样式

1
2
3
4
5
6
7
8
9
PUT / HTTP/1.1 
Host: bucketname.obs.region.example.com
Content-Length: length
Date: date
Authorization: authorization
 
<CreateBucketConfiguration xmlns="http://obs.region.example.com/doc/2015-06-30/">
    <Location>location</Location> 
</CreateBucketConfiguration>

请求消息参数

该请求消息中不带请求参数。

请求消息头

该操作消息头与普通请求一样,请参见表3,但可以带附加消息头,附加请求消息头如下所示。

表1 附加请求消息头

消息头名称

描述

是否必选

x-obs-acl

创建桶时,可以加上此消息头设置桶的权限控制策略,使用的策略为预定义的常用策略,包括:private、public-read、public-read-write、public-read-delivered、public-read-write-delivered。

类型:String

x-obs-storage-class

创建桶时,可以加上此消息头设置桶的默认存储类型,默认存储类型有3种:STANDARD(标准存储)、WARM(温存储)、COLD(冷存储)。如果没有指定此头域,则创建的桶为标准存储类型。

类型:String

x-obs-grant-read

授权给指定domain下的所有用户有READ权限。允许列举桶内对象、列举桶中多段任务、列举桶中多版本对象、获取桶元数据。

类型:String

示例:x-obs-grant-read:id=租户id

x-obs-grant-write

授权给指定domain下的所有用户有WRITE权限。允许创建、删除、覆盖桶内所有对象,允许初始化段、上传段、拷贝段、合并段、取消多段上传任务。

类型:String

示例:x-obs-grant-write:id=租户id

x-obs-grant-read-acp

授权给指定domain下的所有用户有READ_ACP权限。允许读桶的ACL信息。

类型:String

示例:x-obs-grant-read-acp:id=租户id

x-obs-grant-write-acp

授权给指定domain下的所有用户有WRITE_ACP权限,允许修改桶的ACL信息。

类型: 字符串

示例:x-obs-grant-write-acp:id=租户id

x-obs-grant-full-control

授权给指定domain下的所有用户有FULL_CONTROL权限。

类型: 字符串

示例:x-obs-grant-full-control:id=租户id

x-obs-grant-read-delivered

授权给指定domain下的所有用户有READ权限,并且在默认情况下,该READ权限将传递给桶内所有对象。

类型:String

示例:x-obs-grant-read-delivered:id=租户id

x-obs-grant-full-control-delivered

授权给指定domain下的所有用户有FULL_CONTROL权限,并且在默认情况下,该FULL_CONTROL权限将传递给桶内所有对象。

类型:String

示例:x-obs-grant-full-control-delivered:id=租户id

x-obs-fs-file-interface

创建桶时可以带上此消息头以创建并行文件系统。

类型:String

示例:x-obs-fs-file-interface:Enabled

x-obs-epid

企业项目id,开通企业项目的用户可以从企业项目服务获取,格式为uuid,默认项目传“0”或者不带该头域,未开通企业项目的用户可以不带该头域。

类型:String

示例:x-obs-epid:9892d768-2d13-450f-aac7-ed0e44c2585f

x-obs-bucket-object-lock-enabled

创建桶时可以带上此消息头来开启WORM开关。

类型:String

示例:x-obs-bucket-object-lock-enabled:true

请求消息元素

该操作可以带附加请求消息元素,附加请求消息元素的具体描述如表2所示。

表2 附加请求消息元素

元素名称

描述

是否必选

Location

指定Bucket在哪个区域被创建。

  • 使用默认区域的终端节点创桶时
    • 不携带Location,桶将默认创建在默认区域
    • 在Location中指定其它区域,桶将创建在指定区域
  • 使用非默认区域的终端节点创桶时,必须携带Location,并且Location只能指定为该终端节点对应的区域。

有关OBS区域和终端节点的更多信息,请参考终端节点

类型:String

响应消息样式

1
2
3
4
HTTP/1.1 status_code
Location: location
Date: date
Content-Length: length

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应中不带有响应元素。

错误响应消息

无特殊错误,所有错误已经包含在表2中。

请求示例:创建桶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157

<CreateBucketConfiguration xmlns="http://obs.region.example.com/doc/2015-06-30/">
    <Location>region</Location>
</CreateBucketConfiguration>

响应示例:创建桶

1
2
3
4
5
6
7
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

请求示例:创建指定ACL和存储类型的桶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
x-obs-acl:public-read
x-obs-storage-class:STANDARD
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157

<CreateBucketConfiguration xmlns="http://obs.region.example.com/doc/2015-06-30/">
    <Location>region</Location> 
</CreateBucketConfiguration>

响应示例:创建指定ACL和存储类型的桶

1
2
3
4
5
6
7
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

请求示例:创建并行文件系统

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157
x-obs-fs-file-interface: Enabled

<CreateBucketConfiguration xmlns="http://obs.region.example.com/doc/2015-06-30/">
<Location>region</Location> 
</CreateBucketConfiguration>

响应示例:创建并行文件系统

1
2
3
4
5
6
7
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

请求示例:创建桶时打开WORM开关

PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
x-obs-bucket-object-lock-enabled:true
Content-Length: 0

响应示例:创建桶时打开WORM开关

HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 00000184C11AC7A6809F881341842C02
x-reserved-indicator: Unauthorized
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0