Gunakan GetBucketLogging untuk melihat konfigurasi log akses bucket - Object Storage Service

Anda dapat memanggil operasi GetBucketLogging untuk melihat konfigurasi log akses bucket. Hanya pemilik bucket yang dapat menjalankan operasi ini.

Catatan penggunaan

Untuk memanggil operasi GetBucketLogging, Anda harus memiliki izin oss:GetBucketLogging. Untuk informasi selengkapnya, lihat Berikan kebijakan akses kustom kepada Pengguna RAM.

Sintaksis permintaan

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

Header permintaan

Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Header respons

Semua header dalam respons terhadap permintaan DescribeRegions merupakan header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Elemen respons

Name	Type	Example	Description
BucketLoggingStatus	Kontainer	Tidak berlaku	Kontainer untuk status log akses. Elemen anak: LoggingEnabled Elemen induk: None Catatan Jika tidak ada aturan logging yang ditetapkan untuk bucket sumber, OSS tetap mengembalikan isi pesan XML, tetapi elemen BucketLoggingStatus kosong.
LoggingEnabled	Kontainer	Tidak berlaku	Kontainer untuk informasi log akses. Elemen ini dikembalikan saat logging diaktifkan dan tidak dikembalikan saat logging dinonaktifkan. Elemen anak: TargetBucket, TargetPrefix, dan LoggingRole Elemen induk: BucketLoggingStatus
TargetBucket	String	mybucketlogs	Bucket tempat log akses disimpan. Elemen anak: None Elemen induk: BucketLoggingStatus.LoggingEnabled
TargetPrefix	String	mybucket-access_log/	Awalan (prefix) file log akses yang disimpan. Elemen anak: None Elemen induk: BucketLoggingStatus.LoggingEnabled
LoggingRole	String	AliyunOSSLoggingDefaultRole	Peran untuk otorisasi penyimpanan log. Elemen anak: None Elemen induk: BucketLoggingStatus.LoggingEnabled

Contoh

Contoh untuk bucket

Contoh permintaan

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

Contoh respons

Respons contoh saat aturan log telah ditetapkan

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>

Respons untuk bucket tanpa aturan logging

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>

Contoh bucket vektor

Parameter wilayah (region) dalam header Host untuk vector bucket menggunakan ID wilayah standar Alibaba Cloud, seperti cn-hangzhou, bukan ID wilayah OSS lama yang digunakan untuk bucket tujuan umum, seperti oss-cn-hangzhou.

Contoh permintaan

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

Contoh respons

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

Operasi ini didukung oleh SDK berikut:

Alat baris perintah ossutil

Untuk perintah ossutil yang sesuai dengan operasi GetBucketLogging, lihat get-bucket-logging.

Kode error

Kode error	Kode status HTTP	Deskripsi
NoSuchBucket	404	Bucket yang ditentukan tidak ada.
AccessDenied	403	Anda tidak memiliki izin untuk melihat konfigurasi log akses bucket. Izin ini hanya diberikan kepada pemilik bucket.