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的訪問日誌配置。 |