文档中心

列举桶（C++ SDK）

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

首次发布时间：2022.04.08 10:56:29

通过 ListBuckets 获取存储桶（Bucket）列表。您可以列举当前账号所有地域下符合指定条件的存储空间。

注意事项

列举桶之前，您必须具有 tos:ListBuckets 权限。具体操作，请参见权限配置指南。
此接口会返回当前账号所有地域的桶。

示例代码

以下代码用于列举当前账号所有区域的桶。

#include "TosClientV2.h"
using namespace VolcengineTos;

int main(void){
    // 初始化 TOS 账号信息
    // Your Region 填写 Bucket 所在 Region
    std::string region = "Your Region";
    std::string accessKey = std::getenv("TOS_ACCESS_KEY");
    std::string secretKey = std::getenv("TOS_SECRET_KEY");
    // 填写 Bucket 名称，例如 examplebucket
    std::string bucketName = "examplebucket";

    // 初始化网络等资源
    InitializeClient();
    // 创建交互的 client
    TosClientV2 client(region, accessKey, secretKey);

    // 列举桶
    ListBucketsInput input;
    auto output = client.listBuckets(input);
    if (!output.isSuccess()) {
        // 异常处理
        std::cout << "ListBuckets failed." << output.error().String() << std::endl;
        // 释放网络等资源
        CloseClient();
        return -1;
    }
    // 打印桶信息
    std::cout << "ListBuckets Success, the bucket count is :" << output.result().getBuckets().size() << std::endl;
    std::cout << "Bucket Info is" << std::endl;
    for (auto& result : output.result().getBuckets()) {
        std::cout << "bucketName: " << result.getName() << " location: " << result.getLocation()
                  << " createDate: " << result.getCreationDate() << std::endl;
    }
    // 释放网络等资源
    CloseClient();
    return 0;
}

对象存储

列举桶（C++ SDK）

注意事项

示例代码

相关文档