更新时间:2025-08-26 GMT+08:00

创建桶

您可以通过OBS管理控制台、API、SDK、OBS Browser+、obsutil方式创建桶。桶是OBS中存储对象的容器。您需要先创建一个桶,然后才能在OBS中存储数据。

前提条件

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

约束与限制

  • 桶创建成功后,不能修改名称和所属区域。创建时,请设置合适的桶名和区域。
  • 一个账号及账号下的所有IAM用户一共可创建100个桶。建议结合OBS细粒度权限控制能力,合理进行桶规划和使用。例如,建议在桶内根据对象前缀划分不同的目录,通过细粒度权限控制实现不同目录在不同业务部门之间的权限隔离。每个桶中存放的对象的数量和大小总和没有限制,用户不需要考虑数据的可扩展性。

桶命名规则

考虑到桶名会作为访问域名的一部分,需要参与域名解析,因此桶名需要满足DNS域名规范。同时,OBS系统在接受创桶请求时,会对桶名进行严格的检查,具体规则如下:
  • 需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。用户删除桶后,立即创建同名桶或并行文件系统会创建失败,需要等待30分钟才能创建。
  • 长度范围为3到63个字符,支持小写字母、数字、中划线(-)、英文句号(.)。
  • 禁止两个英文句号(.)相邻,禁止英文句号(.)和中划线(-)相邻,禁止以英文句号(.)和中划线(-)开头或结尾。
  • 禁止使用IP地址。

桶命名最佳实践

  • 避免在桶名称中包含“.”。桶名包含"."会导致通过HTTPS访问桶域名(bucketname.obs.regionID.myhuaweicloud.com)时,出现访问失败或者客户端提示证书校验存在风险(比如浏览器安全提示会呈现红色告警)。原因是SSL的通配符证书仅匹配桶名不包含"."的桶。
  • 避免在桶名称中包含敏感信息,桶名称会出现在桶内对象的URL中。
  • 选择避免命名冲突的命名方案。创建桶时请避免选择导致命名冲突的桶命名方案。确保当桶名已被使用时,您的程序会选择其他桶名。

使用方式

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

相关文档