日志控制
更新时间：2020-08-20
应用场景
如果用户需要跟踪BOS的访问请求，可以开启BOS日志功能,并指定存放日志的Bucket和访问日志的文件前缀。每条访问日志记录了单个访问请求的详细信 息，包括请求者，Bucket名称，请求时间，请求操作等。日志可以应用在访问统计，安全审核等方面。
开启Bucket日志功能
如下代码开启了Bucket的日志功能，并指定最终被保存的访问日志文件的前缀：
bos_client.put_bucket_logging(source_bucket, target_bucket, target_prefix)注意：
- 用户必须是源Bucket的owner且拥有FULL_CONTROL权限，且是目标Bucket的owner。
- 源Bucket和目标Bucket必须属于同一个Region。
- 如果源Bucket开通了Logging功能，源Bucket被删除的同时，相应的Logging信息也将被删除。
- 如果Logging的目标Bucket被删除，则源Bucket的Logging功能会被自动关闭。
- "targetPrefix"表示存储访问日志记录的Object名字前缀，可以为空。
日志功能相关参数的详细描述及配置注意事项请参见PutBucketLogging接口。
查询Bucket日志功能
如下代码可以查询Bucket日志功能的配置参数:
response = bos_client.get_bucket_logging(bucket_name)get_bucket_logging方法返回的解析类中可供调用的参数说明如下:
| 参数 | 说明 |
|---|---|
| status | 是否开启了Logging功能 |
| targetBucket | 指定存放访问日志的Bucket，如果未开启Logging功能，响应中无该字段 |
| targetPrefix | 指定最终被保存的访问日志文件前缀，如果未开启Logging功能，响应中无该字段 |
关闭Bucket日志功能
如下代码可以关闭Bucket日志功能:
bos_client.delete_bucket_logging(bucket_name)