Anda dapat memanggil operasi GetBucketLogging untuk melihat konfigurasi log akses sebuah bucket. Hanya pemilik bucket yang dapat melakukan operasi ini.
Catatan penggunaan
Untuk memanggil operasi GetBucketLogging, Anda harus memiliki izin oss:GetBucketLogging. Untuk informasi lebih lanjut, lihat Memberikan Kebijakan Akses Kustom kepada Pengguna RAM.
Sintaks permintaan
GET /?logging HTTP/1.1
Host: Host
Date: GMT Date
Authorization: SignatureValueHeader permintaan
Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.
Header respons
Semua header dalam respons terhadap permintaan DescribeRegions merupakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.
Elemen respons
Nama | Tipe | Contoh | Deskripsi |
BucketLoggingStatus | Kontainer | Tidak berlaku | Kontainer untuk status log akses. Elemen anak: LoggingEnabled Elemen induk: Tidak ada Catatan Jika tidak ada aturan logging yang ditetapkan untuk bucket sumber, OSS tetap mengembalikan pesan XML, tetapi elemen BucketLoggingStatus kosong. |
LoggingEnabled | Kontainer | Tidak berlaku | Kontainer untuk informasi log akses. Elemen ini dikembalikan ketika logging diaktifkan dan tidak dikembalikan ketika logging dinonaktifkan. Elemen anak: TargetBucket, TargetPrefix, dan LoggingRole Elemen induk: BucketLoggingStatus |
TargetBucket | String | mybucketlogs | Bucket tempat log akses disimpan. Elemen anak: Tidak ada Elemen induk: BucketLoggingStatus.LoggingEnabled |
TargetPrefix | String | mybucket-access_log/ | Prefiks file log akses yang disimpan. Elemen anak: Tidak ada Elemen induk: BucketLoggingStatus.LoggingEnabled |
LoggingRole | String | AliyunOSSLoggingDefaultRole | Peran untuk otorisasi penyimpanan log. Elemen anak: Tidak ada 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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eContoh Respons
Contoh respons untuk menetapkan aturan log
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 untuk Bucket Vektor
Parameter region dalam header Host untuk bucket vektor menggunakan ID wilayah standar Alibaba Cloud, seperti cn-hangzhou, bukan ID wilayah OSS lama yang digunakan untuk bucket serbaguna, seperti oss-cn-hangzhou.
Contoh Permintaan
Get /?logging HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou.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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eContoh 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
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
<LoggingEnabled>
<TargetBucket>mybucketlogs</TargetBucket>
<TargetPrefix>mybucket-access_log/</TargetPrefix>
<LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
</LoggingEnabled>
</BucketLoggingStatus>SDK
Operasi ini didukung oleh SDK berikut:
Alat baris perintah ossutil
Untuk perintah ossutil yang sesuai dengan operasi GetBucketLogging, lihat get-bucket-logging.
Kode kesalahan
Kode kesalahan | 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. |