全部产品
Search
文档中心

Object Storage Service:put-bucket-logging

更新时间:Jul 02, 2025

Mengaktifkan logging untuk sebuah bucket Object Storage Service (OSS). Setelah logging diaktifkan, OSS akan menghasilkan objek log akses setiap jam berdasarkan aturan penamaan yang telah ditentukan dan menyimpan objek tersebut di bucket yang ditentukan.

Catatan penggunaan

Sebelum mengaktifkan logging, pastikan Anda memahami fitur ini. Untuk informasi lebih lanjut, lihat Logging.

Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API

Aksi

Definisi

PutBucketLogging

oss:PutBucketLogging

Mengaktifkan logging untuk sebuah bucket.

oss:PutObject

Saat mengaktifkan logging untuk sebuah bucket, jika log ditulis ke bucket lain, izin ini diperlukan untuk bucket tujuan.

Sintaks perintah

ossutil api put-bucket-logging --bucket value --bucket-logging-status value [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--bucket-logging-status

string

Kontainer yang menyimpan informasi status logging.

Catatan

Perintah put-bucket-logging setara dengan operasi PutBucketLogging. Untuk informasi lebih lanjut tentang operasi API, lihat PutBucketLogging.

--bucket-logging-status

Parameter --bucket-logging-status mendukung format XML dan JSON. Jika nilai parameter dimulai dengan "file://", konfigurasi akan dimuat dari file yang ditentukan.

  • Format XML:

    <BucketLoggingStatus>
      <LoggingEnabled>
        <TargetBucket>string</TargetBucket>
        <TargetPrefix>string</TargetPrefix>
      </LoggingEnabled>
    </BucketLoggingStatus>
  • Format JSON:

    {
      "LoggingEnabled": {
        "TargetBucket": "string",
        "TargetPrefix": "string"
      }
    }
Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah.

Contoh

Aktifkan logging untuk bucket examplebucket dengan log akses yang diberi awalan MyLog- dan disimpan di bucket dest-bucket.

  • Gunakan file konfigurasi XML (bucket-logging-status.xml dalam contoh ini)

    <?xml version="1.0" encoding="UTF-8"?>
    <BucketLoggingStatus>
      <LoggingEnabled>
        <TargetBucket>dest-bucket</TargetBucket>
        <TargetPrefix>MyLog-</TargetPrefix>
      </LoggingEnabled>
    </BucketLoggingStatus>

Contoh perintah:

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.xml
  • Gunakan file konfigurasi JSON (bucket-logging-status.json dalam contoh ini)

    {
      "LoggingEnabled": {
        "TargetBucket": "destBucket",
        "TargetPrefix": "MyLog-"
      }
    }

    Contoh perintah:

    ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.json
  • Gunakan parameter JSON di baris perintah

    ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status "{\"LoggingEnabled\":{\"TargetBucket\":\"destBucket\",\"TargetPrefix\":\"MyLog-\"}}"