接口描述

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

请求（Request）

• 请求语法

  Plain Text 复制

  1  PUT /?logging HTTP/1.1
  2  Host: <BucketName>.bj.bcebos.com
  3  Date: <Date>
  4  Authorization: <AuthorizationString>
  5  Content-Length: <ContentLength>
  6
  7  {
  8  	"targetBucket": "TargetBucketName",
  9  	"targetPrefix": "TargetPrefixName"
  10  }

• 请求头域

  无特殊参数

• 请求参数

  名称	描述	类型	是否必须
  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位。
• 重复请求返回结果相同。

示例

• 请求示例

  Plain Text 复制

  1PUT /?logging HTTP/1.1
  2Host: BucketName.bj.bcebos.com
  3Date: Tue, 17 May 2016 08:36:52 GMT
  4Authorization: AuthorizationString
  5Content-Length: 55
  6
  7{
  8	"targetBucket": "dscbucket",
  9	"targetPrefix": "mylog/"
  10}

• 响应示例

  Plain Text 复制

  1HTTP/1.1 200 OK
  2x-bce-request-id: 1a5fd81e-626b-45b3-a885-15fff9cd106c
  3Date: Tue, 17 May 2016 08:36:52 GMT
  4Content-Length: 0
  5Server: BceBos