全部產品
Search
文件中心

:GetBucketLogging

更新時間:Jun 19, 2024

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