更新时间：2026-09-18 GMT+08:00

创建桶

开发过程中，您有任何问题可以在github上提交issue。接口参考文档详细介绍了每个接口的参数和使用方法。

桶是OBS全局命名空间，相当于数据的容器、文件系统的根目录，可以存储若干对象。以下代码展示如何新建一个桶：

obsClient.createBucket("bucketname");

桶命名规则如下：
- 需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。用户删除桶后，立即创建同名桶或并行文件系统会创建失败，需要等待30分钟才能创建。
- 长度范围为3到63个字符，仅支持小写字母、数字、中划线（-）、英文句号（.）。
- 禁止两个英文句号（.）相邻，禁止英文句号（.）和中划线（-）相邻，禁止以英文句号（.）和中划线（-）开头或结尾。
- 禁止使用IP地址。
同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。

创建桶时，如果使用的终端节点归属于默认区域华北-北京一（cn-north-1），则可以不指定区域；如果使用的终端节点归属于其他区域，则必须指定区域，且指定的区域必须与终端节点归属的区域一致。当前有效的区域名称可从这里查询。
您可以使用带参数创建方式，在创建桶时，指定桶的区域位置。

父主题： 快速入门