全部产品
Search
文档中心

Object Storage Service:Pelacakan akses (Python SDK V2)

更新时间:Nov 09, 2025

Topik ini menjelaskan cara menggunakan Python SDK V2 untuk mengonfigurasi fitur pelacakan akses pada sebuah bucket.

Catatan

  • Kode contoh dalam topik ini menggunakan ID wilayah cn-hangzhou untuk Wilayah Hangzhou, Tiongkok sebagai contoh. Secara default, titik akhir publik digunakan. Jika Anda ingin mengakses OSS dari produk Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang pemetaan antara wilayah OSS dan titik akhir, lihat Wilayah dan titik akhir OSS.

Definisi metode

Aktifkan pelacakan akses

put_bucket_access_monitor(request: PutBucketAccessMonitorRequest, **kwargs) → PutBucketAccessMonitorResult

Periksa status pelacakan akses

get_bucket_access_monitor(request: GetBucketAccessMonitorRequest, **kwargs) → GetBucketAccessMonitorResult

Parameter permintaan

Parameter

Tipe

Deskripsi

request

PutBucketAccessMonitorRequest

Parameter permintaan. Untuk informasi lebih lanjut, lihat PutBucketAccessMonitorRequest

GetBucketAccessMonitorRequest

Parameter permintaan. Untuk informasi lebih lanjut, lihat GetBucketAccessMonitorRequest

Nilai kembali

Tipe

Deskripsi

PutBucketAccessMonitorResult

Nilai kembali. Untuk informasi lebih lanjut, lihat PutBucketAccessMonitorResult

GetBucketAccessMonitorResult

Nilai kembali. Untuk informasi lebih lanjut, lihat GetBucketAccessMonitorResult

Untuk definisi lengkap mengaktifkan pelacakan akses, lihat put_bucket_access_monitor.

Untuk definisi lengkap memeriksa status pelacakan akses, lihat get_bucket_access_monitor.

Kode contoh

Aktifkan pelacakan akses

Berikut adalah kode contoh untuk mengaktifkan pelacakan akses pada sebuah bucket:

import argparse
import alibabacloud_oss_v2 as oss

# Buat pengurai argumen baris perintah dan jelaskan tujuan skrip: mengonfigurasi status pelacakan akses untuk sebuah bucket.
parser = argparse.ArgumentParser(description="put bucket access monitor sample")

# Tentukan argumen baris perintah, termasuk wilayah, nama bucket, titik akhir, dan status pelacakan akses yang diperlukan.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--bucket', help='Nama bucket.', required=True)
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')
parser.add_argument('--status', help='Status pelacakan akses bucket. Nilai valid: Enabled, Disabled.', required=True)

def main():
    # Parsing argumen baris perintah untuk mendapatkan nilai yang dimasukkan oleh pengguna.
    args = parser.parse_args()

    # Muat informasi kredensial akses dari variabel lingkungan untuk verifikasi identitas.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Buat objek konfigurasi menggunakan konfigurasi SDK default dan atur penyedia autentikasi.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Atur properti wilayah objek konfigurasi berdasarkan argumen baris perintah yang diberikan oleh pengguna.
    cfg.region = args.region

    # Jika titik akhir kustom disediakan, perbarui properti titik akhir dalam objek konfigurasi.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Inisialisasi klien OSS berdasarkan konfigurasi sebelumnya untuk berinteraksi dengan OSS.
    client = oss.Client(cfg)

    # Kirim permintaan untuk mengonfigurasi status pelacakan akses bucket yang ditentukan.
    result = client.put_bucket_access_monitor(oss.PutBucketAccessMonitorRequest(
            bucket=args.bucket,  # Nama bucket.
            access_monitor_configuration=oss.AccessMonitorConfiguration(
                status=args.status,  # Tetapkan status pelacakan akses baru.
            ),
    ))

    # Cetak kode status dan ID permintaan hasil operasi untuk mengonfirmasi status permintaan.
    print(f'kode status: {result.status_code},'
          f' ID permintaan: {result.request_id}')

# Saat skrip ini dieksekusi langsung, panggil fungsi utama untuk memulai logika pemrosesan.
if __name__ == "__main__":
    main()  # Titik masuk skrip. Alur program dimulai dari sini.

Periksa status pelacakan akses

Berikut adalah kode contoh untuk memeriksa status pelacakan akses sebuah bucket:

import argparse
import alibabacloud_oss_v2 as oss

# Buat pengurai argumen baris perintah dan jelaskan tujuan skrip: mendapatkan status pelacakan akses sebuah bucket.
parser = argparse.ArgumentParser(description="get bucket access monitor sample")

# Tentukan argumen baris perintah, termasuk wilayah dan nama bucket yang diperlukan, serta titik akhir opsional.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--bucket', help='Nama bucket.', required=True)
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')

def main():
    # Parsing argumen baris perintah untuk mendapatkan nilai yang dimasukkan oleh pengguna.
    args = parser.parse_args()

    # Muat informasi kredensial akses dari variabel lingkungan untuk verifikasi identitas.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Buat objek konfigurasi menggunakan konfigurasi SDK default dan atur penyedia autentikasi.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Atur properti wilayah objek konfigurasi berdasarkan argumen baris perintah yang diberikan oleh pengguna.
    cfg.region = args.region

    # Jika titik akhir kustom disediakan, perbarui properti titik akhir dalam objek konfigurasi.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Inisialisasi klien OSS berdasarkan konfigurasi sebelumnya untuk berinteraksi dengan OSS.
    client = oss.Client(cfg)

    # Jalankan permintaan untuk mendapatkan status pelacakan akses bucket yang ditentukan.
    result = client.get_bucket_access_monitor(oss.GetBucketAccessMonitorRequest(
            bucket=args.bucket,  # Nama bucket.
    ))

    # Cetak kode status, ID permintaan, dan status pelacakan akses hasil operasi.
    print(f'kode status: {result.status_code},'
          f' ID permintaan: {result.request_id},'
          f' status: {result.access_monitor_configuration.status},'
    )

# Saat skrip ini dieksekusi langsung, panggil fungsi utama untuk memulai logika pemrosesan.
if __name__ == "__main__":
    main()  # Titik masuk skrip. Alur program dimulai dari sini.

Referensi