日志控制
所有文档

          对象存储 BOS

          日志控制

          应用场景

          如果用户需要跟踪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)
          上一篇
          文件管理
          下一篇
          异常处理