如何通过GCP Cloud Storage Python API仅列出单层级对象且不含子对象？

你可以通过官方Python SDK的delimiter参数配合prefix实现需求，这个参数会让GCP服务端直接过滤出指定前缀下的单层级直接子对象，无需扫描全量对象，性能大幅提升。

核心实现代码 #

from google.cloud import storage

bucket_name = "my-bucket"
target_prefix = "logs/app"

# 初始化客户端
storage_client = storage.Client()

# 确保前缀以斜杠结尾，精准匹配目标"目录"下的子项
if not target_prefix.endswith('/'):
    target_prefix += '/'

# 使用delimiter='/'限定只返回单层级内容
blob_iterator = storage_client.list_blobs(
    bucket_name,
    prefix=target_prefix,
    delimiter='/'
)

# 遍历获取直接子对象（文件）
print("单层级子对象：")
for blob in blob_iterator:
    print(blob.name)

# 如果需要获取子目录（以斜杠结尾的前缀），可以访问iterator的prefixes属性
print("\n子目录前缀：")
for sub_prefix in blob_iterator.prefixes:
    print(sub_prefix)

关键说明 #

• delimiter='/'：告诉GCP服务端只返回prefix路径下的直接子对象，不会递归返回深层嵌套的对象，服务端层面完成过滤，避免客户端全量扫描。
• 前缀结尾的/：必须添加，否则会匹配到类似logs/appXYZ这类名称包含前缀但不属于目标层级的对象，确保只针对logs/app/下的子项。
• 性能优势：即使桶内有百万级对象，该操作也只会返回目标层级的内容，不会遍历全量数据，速度远快于单纯使用prefix的方式。

这个方案完全基于官方GCP Cloud Storage Python SDK实现，不需要额外引入其他SDK。

内容的提问来源于stack exchange，提问作者Alexander Goida