创建桶
功能介绍
创建桶是指按照用户指定的桶名创建一个新桶的操作。
- 默认情况下，一个用户可以拥有的桶的数量不能超过100个。
- 用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。
新创建桶的桶名在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，但可以带附加消息头，附加请求消息头如下所示。
消息头名称 |
描述 |
是否必选 |
|---|---|---|
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 |
否 |
请求消息元素
该操作可以带附加请求消息元素，附加请求消息元素的具体描述如表2所示。
元素名称 |
描述 |
是否必选 |
|---|---|---|
Location |
指定Bucket在哪个区域被创建。
有关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 |
