Object Storage Service:PutBucketLogging

Catatan penggunaan

• Diperlukan izin oss:PutBucketLogging untuk mengaktifkan logging pada sebuah bucket dengan memanggil operasi PutBucketLogging. Untuk informasi selengkapnya, lihat Berikan kebijakan kustom.

• Bucket sumber tempat log dihasilkan dan bucket tujuan tempat log disimpan dapat sama atau berbeda. Namun, bucket tujuan harus dimiliki oleh Akun Alibaba Cloud yang sama dan berada di Wilayah yang sama dengan bucket sumber.

• OSS menghasilkan log akses bucket setiap jam. Namun, permintaan dalam satu jam mungkin dicatat dalam log yang dihasilkan untuk jam sebelumnya atau sesudahnya.

  Untuk informasi selengkapnya mengenai konvensi penamaan objek log dan format log, lihat Logging.

• Sebelum Anda menonaktifkan logging, OSS terus menghasilkan objek log. Hapus objek log yang tidak lagi diperlukan untuk mengurangi biaya penyimpanan Anda.

  Anda dapat mengonfigurasi aturan siklus hidup untuk menghapus objek log secara berkala. Untuk informasi selengkapnya, lihat Aturan siklus hidup berdasarkan waktu modifikasi terakhir.

• Lebih banyak bidang mungkin ditambahkan ke log OSS. Kami menyarankan agar pengembang mempertimbangkan potensi masalah kompatibilitas saat mengembangkan alat pemrosesan log.

Sintaksis permintaan

PUT /?logging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue 
Host: Host
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
    <LoggingEnabled>
        <TargetBucket>TargetBucket</TargetBucket>
        <TargetPrefix>TargetPrefix</TargetPrefix>
    </LoggingEnabled>
</BucketLoggingStatus>

Header permintaan

Permintaan PutBucketLogging hanya berisi header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Elemen permintaan

Header respons

Semua header dalam respons terhadap permintaan PutBucketLogging adalah header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Contoh

Contoh untuk bucket

• Contoh permintaan untuk mengaktifkan logging

  PUT /?logging HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Length: 186
  Date: Thu, 17 Apr 2025 03:21:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  
  <?xml version="1.0" encoding="UTF-8"?>
  <BucketLoggingStatus>
      <LoggingEnabled>
          <TargetBucket>examplebucket</TargetBucket>
          <TargetPrefix>MyLog-</TargetPrefix>
          <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
      </LoggingEnabled>
  </BucketLoggingStatus>

  Contoh respons

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674E888648906008B
  Date: Fri, 04 May 2012 03:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

• Contoh permintaan untuk menonaktifkan logging

  Untuk menonaktifkan logging pada sebuah bucket, cukup kirim BucketLoggingStatus kosong. Contoh:

  PUT /?logging HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Type: application/xml
  Content-Length: 86
  Date: Thu, 17 Apr 2025 04:21:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <?xml version="1.0" encoding="UTF-8"?>
  <BucketLoggingStatus>
  </BucketLoggingStatus>

  Contoh respons

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674125A4D8906008B
  Date: Fri, 04 May 2012 04:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

  Contoh bucket vektor

  Saat menentukan Host untuk vector bucket, gunakan ID wilayah standar Alibaba Cloud (contoh: cn-hangzhou). Jangan gunakan ID wilayah OSS lama (contoh: oss-cn-hangzhou) yang digunakan untuk bucket tujuan umum.

  Contoh permintaan untuk mengaktifkan logging

  PUT /?logging HTTP/1.1
  Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
  Content-Length: 186
  Content-Type: application/json
  Date: Thu, 17 Apr 2025 03:21:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  
  {
    "BucketLoggingStatus": {
      "LoggingEnabled": {
        "TargetBucket": "examplebucket",
        "TargetPrefix": "MyLog-",
        "LoggingRole": "AliyunOSSLoggingDefaultRole"
      }
    }
  }

  Contoh respons

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674E888648906008B
  Date: Fri, 04 May 2012 03:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

OSS SDKs

Gunakan OSS SDK untuk bahasa pemrograman berikut untuk memanggil operasi PutBucketLogging:

• Java

• Python V2

• PHP V2

• Go V2

• C

• .NET

• Node.js

• Ruby

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketLogging, lihat put-bucket-logging.

Kode error