GetBucketLogging - 对象存储 OSS

GetBucketLogging接口用于查看存储空间（Bucket）的访问日志配置。只有Bucket的拥有者才能查看Bucket的访问日志配置。

请求语法

GET /?logging HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

名称	类型	示例值	描述
BucketLoggingStatus	容器	不涉及	访问日志状态信息的容器。子元素：LoggingEnabled 父元素：无说明如果源Bucket未设置日志规则，OSS仍然返回一个XML消息体，但其中的BucketLoggingStatus元素为空。
LoggingEnabled	容器	不涉及	访问日志信息的容器。此元素在开启时返回，关闭时不返回。子元素：TargetBucket, TargetPrefix 父元素：BucketLoggingStatus
TargetBucket	字符	mybucketlogs	指定存放访问日志的Bucket。子元素：无父元素：BucketLoggingStatus.LoggingEnabled
TargetPrefix	字符	mybucket-access_log/	指定最终被保存的访问日志文件前缀。子元素：无父元素：BucketLoggingStatus.LoggingEnabled

示例

请求示例

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Fri, 04 May 2012 05:31:04 GMT  
Authorization: OSS qn6q**************:77Dv****************

返回示例

已设置日志规则的返回示例

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 210  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
    <LoggingEnabled>
        <TargetBucket>mybucketlogs</TargetBucket>
        <TargetPrefix>mybucket-access_log/</TargetPrefix>
    </LoggingEnabled>
</BucketLoggingStatus>

未设置日志规则的返回示例

HTTP/1.1 200 
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 110  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
</BucketLoggingStatus>

SDK

此接口所对应的各语言SDK如下：

错误码

错误码	HTTP 状态码	描述
NoSuchBucket	404	目标Bucket不存在。
AccessDenied	403	没有查看Bucket访问日志配置的权限。只有Bucket的拥有者才能查看Bucket的访问日志配置。