GetBucketLogging
GetBucketLogging接口用于查看存儲空間（Bucket）的訪問日志配置。只有Bucket的擁有者才能查看Bucket的訪問日志配置。
請求語法
GET /?logging HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue當(dāng)您在OSS ON云盒中調(diào)用該接口時，您需要將Host替換為云盒Endpoint。更多信息，請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息，請參見公共請求頭（Common Request Headers）。
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息，請參見公共響應(yīng)頭（Common Response Headers）。
響應(yīng)元素
名稱 | 類型 | 示例值 | 描述 |
BucketLoggingStatus | 容器 | 不涉及 | 訪問日志狀態(tài)信息的容器。 子元素：LoggingEnabled 父元素：無 說明 如果源Bucket未設(shè)置日志規(guī)則，OSS仍然返回一個XML消息體，但其中的BucketLoggingStatus元素為空。 |
LoggingEnabled | 容器 | 不涉及 | 訪問日志信息的容器。此元素在開啟時返回，關(guān)閉時不返回。 子元素：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****************返回示例
已設(shè)置日志規(guī)則的返回示例
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>未設(shè)置日志規(guī)則的返回示例
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
此接口所對應(yīng)的各語言SDK如下：
錯誤碼
錯誤碼 | HTTP 狀態(tài)碼 | 描述 |
NoSuchBucket | 404 | 目標(biāo)Bucket不存在。 |
AccessDenied | 403 | 沒有查看Bucket訪問日志配置的權(quán)限。只有Bucket的擁有者才能查看Bucket的訪問日志配置。 |