简介
本文档提供关于日志管理的 API 概览以及 SDK 示例代码。
API | 操作名 | 操作描述 |
设置日志管理 | 为源存储桶开启日志记录 | |
查询日志管理 | 查询源存储桶的日志配置信息 |
设置日志管理
功能说明
PUT Bucket logging 用于为源存储桶开启日志记录，将源存储桶的访问日志保存到指定的目标存储桶中。
方法原型
CosResult CosAPI::PutBucketLogging(const PutBucketLoggingReq& request, PutBucketLoggingResp* response);
请求示例
qcloud_cos::CosConfig config("./config.json");qcloud_cos::CosAPI cos(config);std::string bucket_name = "examplebucket-1250000000";qcloud_cos::PutBucketLoggingReq req(bucket_name);qcloud_cos::PutBucketLoggingResp resp;qcloud_cos::LoggingEnabled rules;rules.SetTargetBucket(TargetBucketname); // 存放日志的目标存储桶rules.SetTargetPrefix(TargetPrefix); // 日志存放在目标存储桶的指定路径req.SetLoggingEnabled(rules);qcloud_cos::CosResult result = cos.PutBucketLogging(req, &resp);if (result.IsSucc()) {// 请求成功，通过resp获取静态网站配置} else {// 请求失败，可以调用 CosResult 的成员函数输出错误信息，例如 requestID 等}
参数说明
参数 | 参数描述 | 类型 | 是否必填 |
req | PutBucketLogging 操作的请求 | PutBucketLoggingReq | 是 |
resp | PutBucketLogging 操作的响应 | PutBucketLoggingResp | 是 |
PutBucketLoggingReq 提供了如下方法设置存储桶日志的配置信息：
void SetLoggingEnabled(const LoggingEnabled& rules);
LoggingEnabledt 提供如下方法设置配置信息：
class LoggingEnabled {public:void SetTargetBucket(const std::string &targetbucket);void SetTargetPrefix(const std::string &targetprefix);
查询日志管理
功能说明
GET Bucket logging 用于查询指定存储桶的日志配置信息。
方法原型
CosResult CosAPI::GetBucketLogging(const GetBucketLoggingReq& request, GetBucketLoggingResp* response);
请求示例
qcloud_cos::CosConfig config("./config.json");qcloud_cos::CosAPI cos(config);std::string bucket_name = "examplebucket-1250000000";qcloud_cos::GetBucketLoggingReq req(bucket_name);qcloud_cos::GetBucketLoggingResp resp;qcloud_cos::CosResult result = cos.GetBucketLogging(req, &resp);if (result.IsSucc()) {// 请求成功，通过resp获取存储桶日志信息} else {// 请求失败，可以调用 CosResult 的成员函数输出错误信息，例如 requestID 等}
参数说明
参数 | 参数描述 | 类型 | 是否必填 |
req | GetBucketLogging 操作的请求 | GetBucketLoggingReq | 是 |
resp | GetBucketLogging 操作的响应 | GetBucketLoggingResp | 是 |
GetBucketLoggingResp 提供如下方法获取存储桶日志配置信息：
LoggingEnabled GetLoggingEnabled() const;
