产品动态
产品公告
功能名称 | 描述 | 示例代码 |
列出对象 | 提供了查询存储桶下的部分或者全部对象的功能。 |
qcloud_cos::CosAPI InitCosAPI() {uint64_t appid = 12500000000;std::string region = "ap-guangzhou";// bucket 的地域，请参见 https://www.tencentcloud.com/document/product/436/62?from_cn_redirect=1std::string secret_id = "************************************"; //用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/37140?from_cn_redirect=1std::string secret_key = "************************************"; //用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/37140?from_cn_redirect=1qcloud_cos::CosConfig config(appid, secret_id, secret_key, region);qcloud_cos::CosAPI cos_tmp(config);return cos_tmp;}
qcloud_cos::CosAPI InitCosAPI() {// 需要已经获取到临时密钥的结果：tmp_secret_id、tmp_secret_key、// 临时密钥的生成参见 https://www.tencentcloud.com/document/product/436/14048?from_cn_redirect=1#cos-sts-sdkuint64_t appid = 12500000000;std::string region = "ap-guangzhou";std::string tmp_secret_id = "************************************";std::string tmp_secret_key = "************************************";std::string tmp_token = "token";qcloud_cos::CosConfig config(appid, tmp_secret_id, tmp_secret_key, region);config.SetTmpToken(tmp_token);qcloud_cos::CosAPI cos_tmp(config);return cos_tmp;}
CosResult CosAPI::GetBucket(const GetBucketReq& req, GetBucketResp* resp)
void GetBucketDemo(qcloud_cos::CosAPI& cos) {qcloud_cos::GetBucketReq req(bucket_name);// 设置列出的对象名以 prefix 为前缀req.SetPrefix("test");// 设置最大列出多少个对象, 一次 listobject 最大支持1000req.SetMaxKeys(10);qcloud_cos::GetBucketResp resp;qcloud_cos::CosResult result = cos.GetBucket(req, &resp);std::cout << "===================GetBucketResponse=====================" << std::endl;if (result.IsSucc()) {// object contents 表示此次列出的对象列表std::vector<Content> contents = resp.GetContents();for (const Content& content : contents) {// 对象的 keystd::string key = content.m_key;// 对象的 etagstd::string etag = content.m_etag;// 对象的长度std::string file_size = content.m_size;// 对象的存储类型std::string storage_classes = content.m_storage_class;std::cout << "key:" << key << "\\netag:" << etag << "\\nfile_size:" << file_size << "\\nstorage_classes:" << storage_classes << std::endl;std::cout << "==================================" << std::endl;}if (resp.IsTruncated()) {// 表示还没有列完，被截断了// 下一次开始的位置std::string next_marker = resp.GetNextMarker();std::cout << "next_marker:" << next_marker << std::endl;}} else {std::cout << "GetBucket Fail, ErrorMsg: " << result.GetErrorMsg() << std::endl;}std::cout << "=========================================================" << std::endl;}
参数名称 | 描述 | 类型 |
req | 列出对象请求 | GetBucketReq |
resp | 列出对象响应 | GetBucketResp |
成员或函数 | 描述 | 参数类型 |
bucket_name | 存储桶名，可通过构造函数或 set 方法进行设置 | string |
SetPrefix | 限制返回的结果对象，以 prefix 为前缀。不调用则不进行限制，即 Bucket 下所有的成员。 | string |
SetDelimiter | 分隔符，限制返回的是以 prefix 开头，并以 delimiter 第一次出现的结束的路径 | string |
SetMarker | 标记 list 的起点位置，第一次可设置为空，后续请求需设置为上一次 listObjects 返回值中的 nextMarker | string |
SetMaxKeys | 最大返回的成员个数（不得超过1000）。默认值： 1000 | uint64_t |
成员函数 | 描述 | 返回类型 |
GetContents | 获取此次列出的对象列表，具体用法参考上方的请求示例 | vector<Content> |
IsTruncated | 响应是否被截断，有截断返回 true，否则 false | bool |
GetNextMarker | 仅当响应有截断（IsTruncated 为 true）才会返回该节点，该节点的值为当前响应条目中的最后一个对象键，当需要继续请求后续条目时，将该节点的值作为下一次请求的 marker 参数传入 | string |
GetCommonPrefixes | 从 prefix 或从头（如未指定 prefix）到首个 delimiter 之间相同的部分，定义为 Common Prefix。仅当请求中指定了 delimiter 参数才有可能返回该节点。 | vector<std::string> |
GetXCosRequestId | 获取请求 ID | string |
成员函数 | 描述 | 返回类型 |
IsSucc | 判断是否成功，成功返回 true，失败返回 false。 | bool |
GetHttpStatus | 获得 http 状态码。 | int |
GetErrorCode | 请求失败时获取错误码。 | string |
GetErrorMsg | 请求失败时获取错误信息。 | string |
GetXCosRequestId | 获取请求 ID。 | string |
void PrintResult(const qcloud_cos::CosResult& result, const qcloud_cos::BaseResp& resp) {if (result.IsSucc()) {std::cout << "Request Succ." << std::endl;std::cout << resp.DebugString() << std::endl;} else {std::cout << "ErrorMsg=" << result.GetErrorMsg() << std::endl;std::cout << "HttpStatus=" << result.GetHttpStatus() << std::endl;std::cout << "ErrorCode=" << result.GetErrorCode() << std::endl;std::cout << "ErrorMsg=" << result.GetErrorMsg() << std::endl;std::cout << "ResourceAddr=" << result.GetResourceAddr() << std::endl;std::cout << "XCosRequestId=" << result.GetXCosRequestId() << std::endl;std::cout << "XCosTraceId=" << result.GetXCosTraceId() << std::endl;}}
文档反馈