通过 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; }
关于列举桶的 API 文档，请参见 ListBuckets。