判断Bucket是否存在
更新时间：2026-09-23
若用户需要判断某个 Bucket 是否存在，可通过 BOS Python SDK 的 does_bucket_exist(bucket_name) 方法实现。该方法返回布尔值：Bucket 存在时返回 True，不存在时返回 False。
运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name（及其它占位符）替换为实际值。
Python
1# 获取 Bucket 的存在信息，需要传入 Bucket 名称，返回值为布尔型。
2exists = bos_client.does_bucket_exist(bucket_name)
3
4# 输出结果。
5if exists:
6 print("Bucket exists")
7else:
8 print("Bucket not exists")当 Bucket 存在时，输出示例如下：
Text
1Bucket exists当 Bucket 不存在时，输出示例如下：
Text
1Bucket not exists返回值说明如下：
| 返回值 | 类型 | 说明 |
|---|---|---|
exists |
bool |
Bucket 存在时返回 True；Bucket 不存在时返回 False。 |
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
bucket_name |
str |
是 | 待判断是否存在的 Bucket 名称。 |
说明：
该方法底层发送 HEAD 请求：服务端返回 404 Not Found 时判定为不存在（返回
False）；返回 403 Forbidden（无访问权限但 Bucket 存在）时判定为存在（返回True）。其它错误会向上抛出异常。
评价此篇文章