調用GetBucketLogging查看儲存空間的訪問日誌配置 - Object Storage Service

注意事項

如需調用GetBucketLogging介面查看儲存空間（Bucket）的訪問日誌配置，您必須擁有oss:GetBucketLogging許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

請求文法

GET /?logging HTTP/1.1
Host: Host
Date: GMT Date
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

名稱	類型	樣本值	描述
BucketLoggingStatus	容器	不涉及	訪問日誌狀態資訊的容器。子項目：LoggingEnabled 父元素：無說明如果源Bucket未設定日誌規則，OSS仍然返回一個XML訊息體，但其中的BucketLoggingStatus元素為空白。
LoggingEnabled	容器	不涉及	訪問日誌資訊的容器。此元素在開啟時返回，關閉時不返回。子項目：TargetBucket, TargetPrefix, LoggingRole 父元素：BucketLoggingStatus
TargetBucket	字元	mybucketlogs	指定存放訪問日誌的Bucket。子項目：無父元素：BucketLoggingStatus.LoggingEnabled
TargetPrefix	字元	mybucket-access_log/	指定最終被儲存的訪問記錄檔首碼。子項目：無父元素：BucketLoggingStatus.LoggingEnabled
LoggingRole	字串	AliyunOSSLoggingDefaultRole	日誌轉存授權角色。子項目：無父元素：BucketLoggingStatus.LoggingEnabled

樣本

Bucket樣本

請求樣本

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回樣本

已設定日誌規則的返回樣本

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
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>
        <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
    </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>

向量Bucket樣本

向量 Bucket 的Host中的地區參數使用阿里雲標準地區 ID（如 cn-hangzhou），而非用於通用 Bucket 的舊版 OSS 地區（如 oss-cn-hangzhou）

請求樣本

Get /?logging HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回樣本

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

{
  "BucketLoggingStatus": {
    "LoggingEnabled": {
      "TargetBucket": "mybucketlogs",
      "TargetPrefix": "mybucket-access_log/",
      "LoggingRole": "AliyunOSSLoggingDefaultRole"
    }
  }
}

SDK

此介面所對應的各語言SDK如下：

命令列工具ossutil

GetBucketLogging介面所對應的ossutil命令，請參見get-bucket-logging。

錯誤碼

錯誤碼	HTTP 狀態代碼	描述
NoSuchBucket	404	目標Bucket不存在。
AccessDenied	403	沒有查看Bucket訪問日誌配置的許可權。只有Bucket的擁有者才能查看Bucket的訪問日誌配置。