全部产品
Search
文档中心

Object Storage Service:GetBucketLogging

更新时间:Nov 09, 2025

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: SignatureValue

Header 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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh 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=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

<?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.