对象存储BOS

    GetBucketLogging

    接口描述

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

    请求(Request)

    • 请求语法

      Get /?logging HTTP/1.1
      Host: <BucketName>.bj.bcebos.com
      Date: <Date>
      Authorization: <AuthorizationString>
      Content-Length: 0
    • 请求头域

      无特殊参数

    • 请求参数

      无特殊参数

    响应(Response)

    • 响应元素

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

      无特殊头域

    注意事项

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

    示例

    • 请求示例

      Get /?logging HTTP/1.1
      Host: BucketName.bj.bcebos.com
      Date: Tue, 17 May 2016 08:36:52 GMT
      Authorization: AuthorizationString
      Content-Length: 0
    • 响应示例(已设置Log规则)

      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: 71
      Server: BceBos
      
      {
      	"status": "enabled",
      	"targetBucket": "dscbucket",
      	"targetPrefix": "mylog-"
      }
    • 响应示例(未设置Log规则)

      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: 21
      Server: BceBos
      
      {
      	"status": "disabled"
      }
    上一篇
    PutBucketLogging
    下一篇
    DeleteBucketLogging