GetBucketLogging - Query bucket access log configuration - Object Storage Service

Kullanım notları

GetBucketLogging işlemi için oss:GetBucketLogging izni gerekir. RAM kullanıcılarına özel erişim ilkeleri atama.

İstek sözdizimi

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

İstek üstbilgileri

DescribeRegions yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

Yanıt üstbilgileri

Yanıt yalnızca ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Yanıt öğeleri

Name	Type	Example	Description
BucketLoggingStatus	Container	Not applicable	Erişim günlüğü durumu kapsayıcısı. Alt öğe: LoggingEnabled Üst öğe: Yok Not Paket için herhangi bir günlük kaydı kuralı yapılandırılmamışsa OSS, boş bir BucketLoggingStatus öğesi içeren bir XML gövdesi döndürür.
LoggingEnabled	Container	Not applicable	Erişim günlüğü bilgileri kapsayıcısı. Yalnızca günlük kaydı etkinleştirildiğinde döndürülür. Alt öğeler: TargetBucket, TargetPrefix ve LoggingRole Üst öğe: BucketLoggingStatus
TargetBucket	String	mybucketlogs	Erişim günlüklerinin depolandığı paket. Alt öğe: Yok Üst öğe: BucketLoggingStatus.LoggingEnabled
TargetPrefix	String	mybucket-access_log/	Depolanan erişim günlüğü dosyalarının ön eki. Alt öğe: Yok Üst öğe: BucketLoggingStatus.LoggingEnabled
LoggingRole	String	AliyunOSSLoggingDefaultRole	Günlük depolama yetkilendirmesi için kullanılan rol. Alt öğe: Yok Üst öğe: BucketLoggingStatus.LoggingEnabled

Örnekler

Genel amaçlı paket

İstek

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

Yanıt

Günlük kaydı etkinleştirildiğinde yanıt

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>

Günlük kaydı devre dışı bırakıldığında yanıt

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>

Vektör paketi

Vektör paketleri, Host üstbilgisinde eski OSS bölge kimlikleri (örn. oss-cn-hangzhou) yerine standart Alibaba Cloud bölge kimliklerini (örn. cn-hangzhou) kullanır.

İstek

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

Yanıt

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

Desteklenen SDK'lar:

ossutil komut satırı aracı

İlgili ossutil komutu get-bucket-logging'dir.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
NoSuchBucket	404	Belirtilen paket mevcut değil.
AccessDenied	403	Paketin erişim günlüğü yapılandırmasını görüntüleme izniniz yok. Bu izne yalnızca paket sahibi sahiptir.