新建Bucket

更新时间：2026-09-23

运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name（及其它占位符）替换为实际值。

如下代码可以新建一个 Bucket：

                Python
                
                bucket_name = 'example-bucket-name'

if not bos_client.does_bucket_exist(bucket_name):
    bos_client.create_bucket(bucket_name)

参数说明

参数	必填	说明
`bucket_name`	是	待创建的 Bucket 名称。
`tag_list`	否	为 Bucket 设置的标签信息，默认为 `None`。
`enable_maz`	否	是否创建多 AZ（Multi-AZ）类型 Bucket，默认为 `False`。

方法说明如下：

方法	返回值	说明
`bos_client.does_bucket_exist(bucket_name)`	`bool`	判断指定 Bucket 是否存在。返回 `True` 表示 Bucket 已存在，返回 `False` 表示 Bucket 不存在。
`bos_client.create_bucket(bucket_name)`	`BceResponse`	创建指定 Bucket。调用成功且无异常时，表示 Bucket 创建成功。

注意： 由于 Bucket 的名称在所有区域中是唯一的，所以需要保证 bucket_name 不与其他所有区域上的 Bucket 名称相同。 Bucket 的命名有以下规范（SDK 会在请求前进行校验，不符合规范会抛出 ValueError）：

只能包含小写字母、数字和短横线（-）。

必须以小写字母或数字开头和结尾。

长度必须在 3-63 个字符之间。

评价此篇文章

有帮助没帮助

查看Bucket所属的区域

列举Bucket

百度智能云

BOS 对象存储

BOS 对象存储

新建Bucket