Object Storage Service：PutBucketLogging

Catatan penggunaan

• Untuk menggunakan operasi PutBucketLogging, Anda memerlukan izin oss:PutBucketLogging. Untuk detail lebih lanjut, lihat Memberikan kebijakan akses kustom kepada Pengguna RAM.

• Bucket sumber dan tujuan dapat berupa bucket yang sama atau berbeda, tetapi harus berada dalam wilayah yang sama dan milik Akun Alibaba Cloud yang sama.

• File log dihasilkan setiap jam. Namun, file log untuk jam tertentu mungkin tidak mencakup semua permintaan dari jam tersebut. Beberapa permintaan mungkin termasuk dalam file log jam sebelumnya atau sesudahnya.

  Untuk informasi lebih lanjut tentang format dan konvensi penamaan file log, lihat Penyimpanan log.

• OSS akan terus menghasilkan file log hingga Anda menonaktifkan fitur penyimpanan log. Hapus file log yang tidak diperlukan untuk mengurangi biaya penyimpanan.

  Anda dapat menggunakan aturan siklus hidup untuk menghapus file log secara berkala. Untuk detail lebih lanjut, lihat Aturan siklus hidup berdasarkan waktu modifikasi terakhir.

• OSS dapat menambahkan bidang baru ke akhir file log sesuai kebutuhan. Saat mengembangkan alat pemrosesan log, pastikan kompatibilitas dipertimbangkan.

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

Semua header dalam permintaan DescribeRegions adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header permintaan umum.

Elemen permintaan

Header tanggapan

Semua header dalam tanggapan terhadap permintaan DescribeRegions adalah header tanggapan umum. Untuk informasi lebih lanjut, lihat Header tanggapan umum.

Contoh

Contoh Bucket

• Permintaan contoh untuk mengaktifkan penyimpanan log pada sebuah bucket

  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>

  Tanggapan contoh

  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

• Permintaan contoh untuk menonaktifkan penyimpanan log pada sebuah bucket

  Untuk menonaktifkan fitur penyimpanan log pada sebuah bucket, kirim BucketLoggingStatus kosong. Berikut adalah contohnya:

  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>

  Tanggapan contoh

  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

Parameter region di Host 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.

Permintaan contoh untuk mengaktifkan penyimpanan log pada sebuah bucket

PUT /?logging HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou.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"
    }
  }
}

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

SDK

SDK berikut tersedia untuk operasi ini:

• Java

• Python V2

• PHP V2

• Go V2

• C

• .NET

• Node.js

• Ruby

Antarmuka baris perintah ossutil

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

Kode kesalahan