日志控制
更新时间：2026-09-23
应用场景
如果用户需要跟踪 BOS 的访问请求，可以开启 BOS 日志功能，并指定存放日志的 Bucket 和访问日志的文件前缀。每条访问日志记录了单个访问请求的详细信息，包括请求者、Bucket 名称、请求时间、请求操作等。日志可以应用在访问统计、安全审核等方面。
运行以下示例前，请先参考 初始化 完成 BOS Client 初始化，并将示例中的 source_bucket、target_bucket、target_prefix、bucket_name 替换为实际值。
开启 Bucket 日志功能
如下代码开启了 Bucket 的日志功能，并指定最终被保存的访问日志文件的前缀：
Python
1bos_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 功能会被自动关闭。
target_prefix表示存储访问日志记录的 Object 名字前缀，可以为空。
日志功能相关参数的详细描述及配置注意事项请参见 PutBucketLogging 接口。
查询 Bucket 日志功能
如下代码可以查询 Bucket 日志功能的配置参数：
Python
1response = bos_client.get_bucket_logging(bucket_name)get_bucket_logging 方法返回的解析类中可供调用的参数说明如下：
| 参数 | 说明 |
|---|---|
status |
是否开启了 Logging 功能。 |
targetBucket |
指定存放访问日志的 Bucket，如果未开启 Logging 功能，响应中无该字段。 |
targetPrefix |
指定最终被保存的访问日志文件前缀，如果未开启 Logging 功能，响应中无该字段。 |
关闭 Bucket 日志功能
如下代码可以关闭 Bucket 日志功能：
Python
1bos_client.delete_bucket_logging(bucket_name)评价此篇文章