控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

日志管理

最近更新时间:2020-12-29 14:39:05

简介

本文档提供关于日志管理的 API 概览以及 SDK 示例代码。

API 操作名 操作描述
PUT Bucket logging 设置日志管理 为源存储桶开启日志记录
GET Bucket logging 查询日志管理 查询源存储桶的日志配置信息

设置日志管理

功能说明

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 PutBucketLogginge 操作的请求 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 GetBucketLogginge 操作的请求 GetBucketLoggingReq
resp GetBucketLogging 操作的响应 GetBucketLoggingResp

GetBucketLoggingResp 提供如下方法获取存储桶日志配置信息:

LoggingEnabled GetLoggingEnabled() const;
目录