创建桶是指按照用户指定的桶名创建一个新桶的操作。
说明: 默认情况下,一个用户可以拥有的桶的数量不能超过100个。 用户删除桶后,需要等待30分钟才能创建同名桶和并行文件系统。 OBS支持在创建桶时指定桶的AZ类型,您可以开启或关闭多AZ。关闭多AZ时,桶内数据默认存储在单个AZ内;开启多AZ时,桶内数据冗余存储在多个AZ内,可靠性更高。旧桶AZ类型默认为单AZ。 新创建桶的桶名在OBS中必须是唯一的。如果是同一个用户重复创建同一区域的同名桶时返回成功。除此以外的其他场景重复创建同名桶返回桶已存在。用户可以在请求消息头中加入x-obs-acl等参数,设置要创建桶的权限控制策略。
存储类型
允许用户创建不同默认存储类型的桶。发送创桶请求时携带头域“x-obs-storage-class”来指定桶的默认存储类型。桶内对象的存储类型与桶默认存储类型保持一致。存储类型有3种:STANDARD(标准存储)、WARM(低频访问存储)、COLD(归档存储)。如果没有携带此头域 ,则创建的桶为标准存储类型。
当往桶内上传对象时,如果没有指定对象的存储类别(参考PUT上传),则该对象的存储类型取桶的默认存储类型。
OBS标准存储拥有低访问时延和较高的吞吐量,因而适用于有大量热点文件需要频繁访问数据的业务场景,例如: 大数据 、移动应用、热点视频、社交图片等场景。 OBS低频访问存储适用于不频繁访问(少于每月一次访问)但在需要时也要求快速访问数据的业务场景,例如:文件同步/共享、企业备份等场景。与标准存储相比,低频访问存储有相同的数据持久性、吞吐量以及访问时延,且成本较低,但是可用性略低于标准存储。 OBS归档存储适用于很少访问(平均一年访问一次)数据的业务场景,例如:数据归档、长期备份等场景。归档存储安全、持久且成本极低,可以用来替代磁带库。为了保持成本低廉,数据取回时间可能长达数分钟到数小时不等。
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
Authorization
|
string | header | 是 |
请求消息中可带的签名信息。 |
|
Date
|
string | header | 否 |
请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。 |
|
x-obs-acl
|
string | header | 否 |
创建桶时,可以加上此消息头设置桶的权限控制策略,使用的策略为预定义的常用策略,包括:private、public-read、public-read-write、public-read-delivered、public-read-write-delivered、bucket-owner-full-control(各策略详细说明见ACL章节的“使用头域设置ACL”)。 |
|
x-obs-storage-class
|
string | header | 否 |
创建桶时,可以加上此消息头设置桶的默认存储类型,默认存储类型有3种:STANDARD(标准存储)、WARM(低频访问存储)、COLD(归档存储)、HIGH_PERFORMANCE(高性能存储,只有并行文件系统支持)。如果没有指定此头域,则创建的桶为标准存储类型。 |
|
x-obs-grant-read
|
string | header | 否 |
授权给指定domain下的所有用户有READ权限。允许列举桶内对象、列举桶中多段任务、列举桶中多版本对象、获取桶元数据。 |
|
x-obs-grant-write
|
string | header | 否 |
授权给指定domain下的所有用户有WRITE权限。允许创建、删除、覆盖桶内所有对象,允许初始化段、上传段、拷贝段、合并段、取消多段上传任务。 |
|
x-obs-grant-read-acp
|
string | header | 否 |
授权给指定domain下的所有用户有READ_ACP权限。允许读桶的ACL信息。 |
|
x-obs-grant-write-acp
|
string | header | 否 |
授权给指定domain下的所有用户有WRITE_ACP权限,允许修改桶的ACL信息。 |
|
x-obs-grant-full-control
|
string | header | 否 |
授权给指定domain下的所有用户有FULL_CONTROL权限。 |
|
x-obs-grant-read-delivered
|
string | header | 否 |
授权给指定domain下的所有用户有READ权限,并且在默认情况下,该READ权限将传递给桶内所有对象。 |
|
x-obs-grant-full-control-delivered
|
string | header | 否 |
授权给指定domain下的所有用户有FULL_CONTROL权限,并且在默认情况下,该FULL_CONTROL权限将传递给桶内所有对象。 |
|
x-obs-az-redundancy
|
string | header | 否 |
创建桶时带上此消息头设置桶的存储类型为多AZ。不携带时默认为单AZ。用户携带该头域指定新创的桶的存储类型为多AZ,存在一种情况是当该区域如果不支持多AZ存储,则该桶的存储类型仍为单AZ。 |
|
x-obs-fs-file-interface
|
string | header | 否 |
创建桶时可以带上此消息头以创建并行文件系统。 |
|
x-obs-epid
|
string | header | 否 |
企业项目id,开通企业项目的用户可以从企业项目服务获取,格式为uuid,默认项目传“0”或者不带该头域,未开通企业项目的用户可以不带该头域。 |
|
x-obs-cluster-type
|
string | header | 否 |
指定桶是创建在公共集群还是专属集群。 |
|
x-obs-location-clustergroup-id
|
string | header | 否 |
集群显性化创桶时,指定的集群组ID |
|
x-obs-ies-location
|
string | header | 否 |
如果是要创建在IES站点上,则指定IES站点的AZ ID。此参数和x-obs-cluster-type不可共存。 |
|
bucket_name
|
string | query | 是 |
考虑到桶名会作为访问 域名 的一部分,需要参与 域名解析 ,因此桶名需要满足DNS域名规范。OBS系统在接受创桶请求时,会对桶名进行严格的检查,具体规则如下: 需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。用户删除桶后,立即创建同名桶或并行文件系统会创建失败,需要等待30分钟才能创建。 长度范围为3到63个字符,支持小写字母、数字、中划线(-)、英文句号(.)。 禁止两个英文句号(.)相邻,禁止英文句号(.)和中划线(-)相邻,禁止以英文句号(.)和中划线(-)开头或结尾。 禁止使用IP地址。 须知: 当使用HTTPS协议访问OBS系统时,由于SSL的通配符证书仅匹配不包含"."的桶。这将导致桶名包含"."的桶在访问OBS系统时,客户端会提示证书校验存在风险,比如浏览器安全提示会呈现红色告警。因此如非必要,请尽量不要在桶名中包含"."。 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
Location
|
string | 否 |
指定Bucket在哪个区域被创建。 使用华北-北京一的 终端节点 创桶时 不携带Location,桶将默认创建在华北-北京一(cn-north-1) 在Location中指定其它区域,例如华北-北京四(cn-north-4),桶将创建在指定区域 使用华北-北京一以外其它区域的终端节点创桶时,必须携带Location,并且Location只能指定为该终端节点对应的区域。 例如使用obs.cn-north-4.myhuaweicloud.com终端节点创桶时,必须指定Location为cn-north-4。 有关OBS区域和终端节点的更多信息,请参考地区和终端节点。 |
成功响应消息
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
Content-Length
|
string | 否 |
响应消息体的字节长度。 |
|
Connection
|
string | 否 |
指明与服务器的连接是长连接还是短连接。 |
|
Date
|
string | 否 |
OBS系统响应的时间。 |
|
ETag
|
string | 否 |
对象的base64编码的128位MD5摘要。ETag是对象内容的唯一标识,可以通过该值识别对象内容是否有变化。比如上传对象时ETag为A,下载对象时ETag为B,则说明对象内容发生了变化。实际的ETag是对象的哈希值。ETag只反映变化的内容,而不是其元数据。上传的对象或拷贝操作创建的对象,通过MD5加密后都有唯一的ETag。如果通过多段上传对象,则无论加密方法如何,MD5会拆分ETag,此类情况ETag就不是MD5的摘要。 |
|
x-obs-id-2
|
string | 否 |
帮助定位问题的特殊符号。 |
|
x-obs-request-id
|
string | 否 |
由OBS创建来唯一确定本次请求的值,可以通过该值来定位问题。 |
在指定location上创建桶名为bucketname的3az桶。
