接口描述

本接口用来获取某个Bucket的访问日志配置情况。

请求（Request）

• 请求语法

  Plain Text 复制

  1Get /?logging HTTP/1.1
  2Host: <BucketName>.bj.bcebos.com
  3Date: <Date>
  4Authorization: <AuthorizationString>
  5Content-Length: 0

• 请求头域

  无特殊参数

• 请求参数

  无特殊参数

响应（Response）

• 响应元素

  名称	描述
  status	Bucket的访问日志功能的开启状态，取值为enabled和disabled。enabled代表已开启，disabled代表未开启。
  targetBucket	指定存放访问日志的Bucket，如果未开启Logging功能，响应中无该字段。
  targetPrefix	指定最终被保存的访问日志文件前缀，如果未开启Logging功能，响应中无该字段。

• 响应头域

  无特殊头域

注意事项

• 如果请求的源Bucket不存在，返回404错误，错误码为NoSuchBucket。
• 请求者只有是源Bucket的owner且拥有FULL_CONTROL权限才允许查看，否则返回403错误，错误码为AccessDenied。

示例

• 请求示例

  Plain Text 复制

  1Get /?logging HTTP/1.1
  2Host: BucketName.bj.bcebos.com
  3Date: Tue, 17 May 2016 08:36:52 GMT
  4Authorization: AuthorizationString
  5Content-Length: 0

• 响应示例（已设置Log规则）

  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: 71
  5Server: BceBos
  6
  7{
  8	"status": "enabled",
  9	"targetBucket": "dscbucket",
  10	"targetPrefix": "mylog-"
  11}

• 响应示例（未设置Log规则）

  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: 21
  5Server: BceBos
  6
  7{
  8	"status": "disabled"
  9}