开启Bucket的访问日志
所有文档

          对象存储 BOS

          开启Bucket的访问日志

          接口说明

          本接口用来开启Bucket的访问日志并指定存放日志的Bucket和访本接口用来开启Bucket的访问日志并指定存放日志的Bucket和访问日志的文件前缀。访问日志的规则请参见日志命名规则日志格式

          注意事项

          • 用户必须是源Bucket的owner且拥有FULL_CONTROL权限,且是目标Bucket的owner。
          • 源Bucket和目标Bucket必须同时存在。
          • 源Bucket和目标Bucket必须属于同一个Region。
          • 如果HTTP Body中Json不合法,BOS会返回CODE_MALFORMED_JSON错误。
          • 如果HTTP Body中Json有无效字段,BOS会返回CODE_INAPPROPRIATE_JSON错误。
          • 用户可将不同的源Bucket的Logging都保存在同一个目标Bucket内,建议指定不同的 targetPrefix便于区分。
          • 如果源Bucket开通了Logging功能,源Bucket被删除的同时,相应的Logging信息也将被删除。
          • 如果Logging的目标Bucket被删除,则源Bucket的Logging功能会被自动关闭。
          • 如果需要修改目标Bucket等信息,可再发送一个PutBucketLogging请求,请求中包含需要修改的信息。
          • targetPrefix表示存储访问日志记录的Object名字前缀,可以为空。如果不为空时,targetPrefix可以包含字母、数字、中划线、下划线、斜杠,且必须以字母开头,长度不大于32位。
          • 重复请求返回结果相同。

          请求URI

          PUT /v1/{bucketName}/?logging

          参数名称 参数类型 是否必须 描述 示例值 参数位置
          bucketName String bucket的名称xxx "bucketName_example" Path

          请求体参数

          请求体字段数据结构说明

          参数名称 参数类型 是否必须 描述 示例值
          targetBucket String 指定存放访问日志的Bucket TargetBucketName
          targetPrefix String 指定最终被保存的访问日志文件前缀 TargetPrefixName

          响应体参数

          请求示例

          PUT /v1/bucketName_example/?logging
          <公共请求头>
          
          
          {
            "targetPrefix" : "TargetPrefixName",
            "targetBucket" : "TargetBucketName"
          }

          响应示例

          错误码

          请参考通用错误码

          上一篇
          获取Bucket的访问日志配置
          下一篇
          关闭Bucket的访问日志配置