对象存储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)
    一篇
    文件管理
    一篇
    异常处理