GetBucketLogging用於查看Bucket的訪問日誌配置情況。

請求文法

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

響應元素(Response Elements)

表 1. 響應元素
名稱 類型 描述
BucketLoggingStatus 容器 訪問日誌狀態資訊的容器。

子項目：LoggingEnabled

父元素：無
LoggingEnabled 容器 訪問日誌資訊的容器。這個元素在開啟時需要，關閉時不需要。

子項目：TargetBucket, TargetPrefix

父元素：BucketLoggingStatus
TargetBucket 字元 指定存放訪問日誌的Bucket。

子項目：無

父元素：BucketLoggingStatus.LoggingEnabled
TargetPrefix 字元 指定最終被保存的訪問記錄檔首碼。

子項目：無

父元素：BucketLoggingStatus.LoggingEnabled

細節分析

  • 如果Bucket不存在，返回404 no content錯誤。錯誤碼：NoSuchBucket。
  • 只有Bucket的擁有者才能查看Bucket的訪問日誌配置情況，否則返回403 Forbidden錯誤，錯誤碼：AccessDenied。
  • 如果源Bucket未設定Logging規則，OSS仍然返回一個XML消息體，但其中的BucketLoggingStatus元素為空。

樣本

請求樣本：

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Fri, 04 May 2012 05:31:04 GMT  
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3naA=

已設定LOG規則的返回樣本：

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906008B
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>

未設定LOG規則的返回樣本：

HTTP/1.1 200 
x-oss-request-id: 534B371674E88A4D8906008B
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>