桶（Bucket）是 TOS 的全局唯一的命名空间，相当于数据的容器，用来储存对象（Object）数据。您可以列举当前账号下所有区域的桶(Bucket)。
tos:ListBuckets 权限。具体操作，请参见权限配置指南。以下代码用于列举当前账号所有区域的桶。
import os import tos # 从环境变量获取 AK 和 SK 信息。 ak = os.getenv('TOS_ACCESS_KEY') sk = os.getenv('TOS_SECRET_KEY') # your endpoint 和 your region 填写Bucket 所在区域对应的Endpoint。# 以华北2(北京)为例，your endpoint 填写 tos-cn-beijing.volces.com，your region 填写 cn-beijing。 endpoint = "your endpoint" region = "your region" try: client = tos.TosClientV2(ak, sk, endpoint, region) # 例举所有桶 resp = client.list_buckets() for bucket in resp.buckets: print("name:{}".format(bucket.name)) print("location:{}".format(bucket.location)) print("extranet_endpoint:{}".format(bucket.extranet_endpoint)) print("intranet_endpoint:{}".format(bucket.intranet_endpoint)) print("creation_date:{}".format(bucket.creation_date)) except tos.exceptions.TosClientError as e: # 操作失败，捕获客户端异常，一般情况为非法请求参数或网络异常 print('fail with client error, message:{}, cause: {}'.format(e.message, e.cause)) except tos.exceptions.TosServerError as e: # 操作失败，捕获服务端异常，可从返回信息中获取详细错误信息 print('fail with server error, code: {}'.format(e.code)) # request id 可定位具体问题，强烈建议日志中保存 print('error with request id: {}'.format(e.request_id)) print('error with message: {}'.format(e.message)) print('error with http code: {}'.format(e.status_code)) print('error with ec: {}'.format(e.ec)) print('error with request url: {}'.format(e.request_url)) except Exception as e: print('fail with unknown error: {}'.format(e))
关于列举桶的 API 文档，请参见 ListBuckets。