日志控制

应用场景

如果用户需要跟踪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方法返回的解析类中可供调用的参数说明如下:

关闭Bucket日志功能

如下代码可以关闭Bucket日志功能:

bos_client.delete_bucket_logging(bucket_name)