GetBucketLogging接口用于查看存储空间（Bucket）的访问日志配置。只有Bucket的拥有者才能查看Bucket的访问日志配置。
注意事项
如需调用GetBucketLogging接口查看存储空间（Bucket）的访问日志配置，您必须拥有oss:GetBucketLogging权限。具体操作，请参见为RAM用户授权自定义的权限策略。
请求语法
GET /?logging HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue当您在OSS ON云盒中调用该接口时，您需要将Host替换为云盒Endpoint。更多信息，请参见云盒Endpoint。
请求头
此接口仅涉及公共请求头。更多信息，请参见公共请求头（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如下：
Java
Python
PHP
Go V2
C
.NET
Node.js
Ruby
命令行工具ossutil
GetBucketLogging接口所对应的ossutil命令，请参见get-bucket-logging。
错误码
错误码 | HTTP 状态码 | 描述 |
NoSuchBucket | 404 | 目标Bucket不存在。 |
AccessDenied | 403 | 没有查看Bucket访问日志配置的权限。只有Bucket的拥有者才能查看Bucket的访问日志配置。 |