新建Bucket

更新时间：2026-09-20

如下代码可以新建一个 Bucket。运行前请先完成 BOS Client 初始化，并将示例中的鉴权信息、Endpoint 和 Bucket 名称替换为实际值：

                Python
                
            

                from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient

access_key_id = 'your-access-key-id'
secret_access_key = 'your-secret-access-key'
endpoint = 'https://bj.bcebos.com'
bucket_name = 'example-bucket-name'

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint
)
bos_client = BosClient(config)

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

参数说明

参数	必填	说明
`access_key_id`	是	百度智能云 Access Key ID。
`secret_access_key`	是	百度智能云 Secret Access Key。
`endpoint`	是	BOS 服务访问地址，例如 `https://bj.bcebos.com`。
`bucket_name`	是	待创建的 Bucket 名称。

方法说明如下：

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

注意： 由于 Bucket 的名称在所有区域中是唯一的，所以需要保证 bucketName 不与其他所有区域上的 Bucket 名称相同。 Bucket 的命名有以下规范：

只能包括小写字母，数字，短横线（-）。

必须以小写字母或者数字开头。

长度必须在 4-63 字节之间。

评价此篇文章

有帮助没帮助

查看Bucket所属的区域

列举Bucket

百度智能云

BOS 对象存储

BOS 对象存储

新建Bucket