閱讀966 返回首頁    go 群英


GetBucketLogging__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲

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

請求語法

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

響應元素(Response Elements)

名稱 描述
BucketLoggingStatus 訪問日誌狀態信息的容器
類型: 容器
子元素: LoggingEnabled
父元素: 無
LoggingEnabled 訪問日誌信息的容器。這個元素在開啟時需要,關閉時不需要。
類型: 容器
子元素: TargetBucket, TargetPrefix
父元素: BucketLoggingStatus
TargetBucket 指定存放訪問日誌的Bucket。
類型: 字符
子元素: 無
父元素: BucketLoggingStatus.LoggingEnabled
TargetPrefix 指定最終被保存的訪問日誌文件前綴。
類型: 字符
子元素: None
父元素: BucketLoggingStatus.LoggingEnabled

細節分析

  1. 如果Bucket不存在,返回404 no content錯誤。錯誤碼:NoSuchBucket。
  2. 隻有Bucket的擁有者才能查看Bucket的訪問日誌配置情況,否則返回403 Forbidden錯誤,錯誤碼:AccessDenied。
  3. 如果源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=”https://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=”https://doc.oss-cn-hangzhou.aliyuncs.com”>
</BucketLoggingStatus>

最後更新:2016-11-23 17:16:08

  上一篇:go GetBucketInfo__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲
  下一篇:go GetBucketWebsite__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲