所有文档

          对象存储 BOS

          PutBucketLogging

          接口描述

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

          请求(Request)

          • 请求语法

            PUT /?logging HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            Date: <Date>
            Authorization: <AuthorizationString>
            Content-Length: <ContentLength>
            
            {
            	"targetBucket": "TargetBucketName",
            	"targetPrefix": "TargetPrefixName"
            }
          • 请求头域

            无特殊参数

          • 请求参数

            名称 描述 类型 是否必须
            targetBucket 指定存放访问日志的Bucket 字符串
            targetPrefix 指定最终被保存的访问日志文件前缀 字符串 否(建议填写,用以区分访问日志)

          响应(Response)

          • 响应元素

            无特殊元素

          • 响应头域

            无特殊头域

          注意事项

          • 用户必须是源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 /?logging HTTP/1.1
            Host: BucketName.bj.bcebos.com
            Date: Tue, 17 May 2016 08:36:52 GMT
            Authorization: AuthorizationString
            Content-Length: 55
            
            {
            	"targetBucket": "dscbucket",
            	"targetPrefix": "mylog/"
            }
          • 响应示例

            HTTP/1.1 200 OK
            x-bce-request-id: 1a5fd81e-626b-45b3-a885-15fff9cd106c
            Date: Tue, 17 May 2016 08:36:52 GMT
            Content-Length: 0
            Server: BceBos
          上一篇
          生命周期
          下一篇
          GetBucketLogging