开启Bucket的访问日志

更新时间：2021-12-29

接口说明

本接口用来开启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位。
重复请求返回结果相同。

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"
}

无

请参考通用错误码