简介
本文档提供关于版本控制的 API 概览以及 SDK 示例代码。
API | 操作名 | 操作描述 |
设置版本控制 | 设置存储桶的版本控制功能 | |
查询版本控制 | 查询存储桶的版本控制信息 |
设置版本控制
功能说明
设置指定存储桶的版本控制功能(PUT Bucket versioning)。
方法原型
CosResult BucketOp::PutBucketVersioning(const PutBucketVersioningReq& req, PutBucketVersioningResp* resp);
请求示例
qcloud_cos::CosConfig config("./config.json");qcloud_cos::CosAPI cos(config);std::string bucket_name = "examplebucket-1250000000";qcloud_cos::PutBucketVersioningReq req(bucket_name);qcloud_cos::PutBucketVersioningResp resp;// 开启版本控制req.SetStatus(true);qcloud_cos::CosResult result = cos.PutBucketVersioning(req, &resp);if (result.IsSucc()) {// 请求成功} else {// 请求失败,可以调用 CosResult 的成员函数输出错误信息,例如 requestID 等}
参数说明
参数 | 参数描述 | 类型 | 是否必填 |
req | PutBucketVersioning 操作的请求 | PutBucketVersioningReq | 是 |
resp | PutBucketVersioning 操作的响应 | PutBucketVersioningResp | 是 |
PutBucketVersioningReq 提供了如下方法开启或暂停版本控制:
void SetStatus(bool is_enable);
查询版本控制
功能说明
查询指定存储桶的版本控制信息(GET Bucket versioning)。
方法原型
CosResult CosAPI::GetBucketVersioning(const GetBucketVersioningReq& request, GetBucketVersioningResp* response);
请求示例
qcloud_cos::CosConfig config("./config.json");qcloud_cos::CosAPI cos(config);std::string bucket_name = "examplebucket-1250000000";qcloud_cos::GetBucketVersioningReq req(bucket_name);qcloud_cos::GetBucketVersioningResp resp;qcloud_cos::CosResult result = cos.GetBucketVersioning(req, &resp);if (result.IsSucc()) {// 请求成功,通过resp的方法获取版本控制状态} else {// 请求失败,可以调用 CosResult 的成员函数输出错误信息,例如 requestID 等}
参数说明
参数 | 参数描述 | 类型 | 是否必填 |
req | GetBucketVersioning 操作的请求 | GetBucketVersioningReq | 是 |
resp | GetBucketVersioning 操作的响应 | GetBucketVersioningResp | 是 |
GetBucketVersioningResp 提供以下方法获取版本控制状态:
int GetStatus() const;