创建桶

使用场景

桶是OBS中存储对象的容器。创建桶之后，然后才能在OBS中存储数据。

前提条件

创建桶之前需要进行一些准备工作，如注册账号，充值，获取访问密钥（AK/SK）和终端节点（Endpoint）等，详情请参见快速入门。

约束与限制

• 桶创建成功后，不能修改名称和所属区域。创建时，请设置合适的桶名和区域。
• 一个账号及账号下的所有IAM用户一共可创建100个桶。建议结合OBS细粒度权限控制能力，合理进行桶规划和使用。例如，建议在桶内根据对象前缀划分不同的目录，通过细粒度权限控制实现不同目录在不同业务部门之间的权限隔离。每个桶中存放的对象的数量和大小总和没有限制，用户不需要考虑数据的可扩展性。
• 考虑到桶名会作为访问域名的一部分，需要参与域名解析，因此桶名需要满足DNS域名规范。OBS系统在接受创桶请求时，会对桶名进行严格的检查，具体规则如下：
  • 需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。用户删除桶后，立即创建同名桶或并行文件系统会创建失败，需要等待30分钟才能创建。
  • 长度范围为3到63个字符，支持小写字母、数字、中划线（-）、英文句号（.）。
  • 禁止两个英文句号（.）相邻，禁止英文句号（.）和中划线（-）相邻，禁止以英文句号（.）和中划线（-）开头或结尾。
  • 禁止使用IP地址。
  

  当使用HTTPS协议访问OBS系统时，由于SSL的通配符证书仅匹配不包含"."的桶。这将导致桶名包含"."的桶在访问OBS系统时，客户端会提示证书校验存在风险，比如浏览器安全提示会呈现红色告警。因此如非必要，请尽量不要在桶名中包含"."。

使用方式

OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式创建桶。

如何访问已创建的桶

桶创建成功后，可以使用桶访问域名来访问桶。您可以根据访问域名结构自行拼接，也可以通过在OBS管理控制台、OBS Browser+上查看桶基本信息获取。

访问域名的结构和示例如下：

【结构】BucketName.Endpoint

【示例】bucketname.obs.ap-southeast-1.myhuaweicloud.com

创建桶失败的原因和解决方法

请参见创建桶失败处理。