GetBucketLogging
更新时间:2020-07-09
接口描述
本接口用来获取某个Bucket的访问日志配置情况。
请求(Request)
-
请求语法
Get /?logging HTTP/1.1 Host: <BucketName>.bj.bcebos.com Date: <Date> Authorization: <AuthorizationString> Content-Length: 0
-
请求头域
无特殊参数
-
请求参数
无特殊参数
响应(Response)
-
响应元素
名称 描述 status Bucket的访问日志功能的开启状态,取值为 enabled
和disabled
。enabled
代表已开启,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" }