GetBucketLogging
所有文档

          对象存储 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