OSS允许用户对Bucket设置访问日志记录，设置之后对于Bucket的访问会被记录成日志，日志存储在OSS上由用户指定的Bucket中。

日志文件的格式为：

<TargetPrefix><SourceBucket>-YYYY-mm-DD-HH-MM-SS-UniqueString

其中TargetPrefix由用户指定。日志规则由以下3项组成：

  • enable，是否开启
  • target_bucket，存放日志文件的Bucket
  • target_prefix，日志文件的前缀

更多关于访问日志的内容请参考Bucket访问日志。

开启Bucket日志

通过Bucket#logging=来开启日志功能： 

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')

bucket.logging = BucketLogging.new(
  enable: true, target_bucket: 'logging_bucket', target_prefix: 'my-log')

查看Bucket日志设置

通过Bucket#logging来查看日志设置： 

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')
log = bucket.logging
puts log.to_s

关闭Bucket日志

通过Bucket#logging=来关闭日志功能： 

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

bucket = client.get_bucket('my-bucket')
bucket.logging = BucketLogging.new(enable: false)