文档中心

列举桶（Python SDK）

最近更新时间：2024.02.04 18:30:54

首次发布时间：2021.12.31 17:38:35

桶（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))

对象存储

列举桶（Python SDK）

注意事项

示例代码

相关文档