文档首页/ 对象存储服务 OBS/ API参考（阿布扎比区域）/ API/ 桶的基础操作/ 创建桶

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

查看PDF

创建桶

功能介绍

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

默认情况下，一个用户可以拥有的桶的数量不能超过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冷存储适用于很少访问（平均一年访问一次）数据的业务场景，例如：数据归档、长期备份等场景。冷存储安全、持久且成本极低，可以用来替代磁带库。为了保持成本低廉，数据恢复时间可能长达数分钟到数小时不等。

请求消息样式

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	否

响应消息样式

HTTP/1.1 status_code
Location: location
Date: date
Content-Length: length

响应消息头

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

响应消息元素

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

错误响应消息

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

请求示例：创建桶

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>

响应示例：创建桶

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和存储类型的桶

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和存储类型的桶

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

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

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>

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

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

父主题： 桶的基础操作

上一篇：获取桶列表

下一篇：列举桶内对象

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消