全部产品
Search
文档中心

Object Storage Service:Akses waktu nyata untuk objek Arsip menggunakan OSS SDK untuk Python 2.0

更新时间:Oct 22, 2025

Topik ini menjelaskan cara menggunakan Python SDK V2 untuk mengelola akses waktu nyata objek Arsip pada sebuah bucket.

Catatan penggunaan

  • Kode contoh dalam topik ini menggunakan ID Wilayah cn-hangzhou dari Wilayah (Hangzhou) Tiongkok. Secara default, titik akhir publik digunakan untuk mengakses sumber daya di bucket. Jika Anda ingin mengakses sumber daya di bucket melalui layanan Alibaba Cloud lainnya di wilayah yang sama dengan lokasi bucket, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang wilayah dan titik akhir yang didukung oleh OSS, lihat Wilayah dan Titik Akhir OSS.

Definisi metode

Aktifkan akses waktu nyata objek Arsip untuk sebuah bucket

put_bucket_archive_direct_read(request: PutBucketArchiveDirectReadRequest, **kwargs) → PutBucketArchiveDirectReadResult

Periksa apakah akses waktu nyata objek Arsip diaktifkan untuk sebuah bucket

get_bucket_archive_direct_read(request: GetBucketArchiveDirectReadRequest, **kwargs) → GetBucketArchiveDirectReadResult

Parameter permintaan

Parameter

Tipe

Deskripsi

request

PutBucketArchiveDirectReadRequest

Parameter permintaan. Untuk informasi lebih lanjut, lihat PutBucketArchiveDirectReadRequest

GetBucketArchiveDirectReadRequest

Parameter permintaan. Untuk informasi lebih lanjut, lihat GetBucketArchiveDirectReadRequest

Parameter respons

Tipe

Deskripsi

PutBucketArchiveDirectReadResult

Parameter respons. Untuk informasi lebih lanjut, lihat PutBucketArchiveDirectReadResult

GetBucketArchiveDirectReadResult

Parameter respons. Untuk informasi lebih lanjut, lihat GetBucketArchiveDirectReadResult

Untuk definisi lengkap metode untuk mengaktifkan akses waktu nyata objek Arsip pada sebuah bucket, lihat put_bucket_archive_direct_read.

Untuk definisi lengkap metode untuk memeriksa apakah akses waktu nyata objek Arsip diaktifkan pada sebuah bucket, lihat get_bucket_archive_direct_read.

Kode contoh

Aktifkan akses waktu nyata objek Arsip untuk sebuah bucket

Anda dapat menggunakan kode berikut untuk mengaktifkan akses waktu nyata objek Arsip pada sebuah bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser argumen baris perintah dan jelaskan tujuan skrip: atur konfigurasi untuk akses waktu nyata objek Arsip untuk sebuah bucket.
parser = argparse.ArgumentParser(description="set konfigurasi akses langsung arsip bucket")

# Tentukan argumen baris perintah, termasuk wilayah, nama bucket, endpoint yang diperlukan, dan apakah akan mengaktifkan akses waktu nyata objek Arsip.
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('--enabled', help='Menentukan apakah akan mengaktifkan akses waktu nyata objek Arsip untuk sebuah bucket. Nilai valid: "true" atau "false".', 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 otentikasi.
    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

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

    # Jalankan permintaan untuk mengatur konfigurasi akses waktu nyata objek Arsip untuk bucket yang ditentukan.
    result = client.put_bucket_archive_direct_read(oss.PutBucketArchiveDirectReadRequest(
            bucket=args.bucket,  # Nama bucket.
            archive_direct_read_configuration=oss.ArchiveDirectReadConfiguration(
                enabled=args.enabled.lower() == 'true',  # Ubah nilai Boolean dalam format string ke tipe Boolean Python.
            ),
    ))

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

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

Periksa apakah akses waktu nyata objek Arsip diaktifkan untuk sebuah bucket

Anda dapat menggunakan kode berikut untuk memeriksa apakah akses waktu nyata objek Arsip diaktifkan pada sebuah bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser argumen baris perintah dan jelaskan tujuan skrip: dapatkan konfigurasi untuk akses waktu nyata objek Arsip untuk sebuah bucket.
parser = argparse.ArgumentParser(description="dapatkan konfigurasi akses langsung arsip bucket")

# Tentukan argumen baris perintah, termasuk wilayah, nama bucket, dan endpoint 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')

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

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

    # Jalankan permintaan untuk mendapatkan detail konfigurasi akses waktu nyata objek Arsip untuk bucket yang ditentukan.
    result = client.get_bucket_archive_direct_read(oss.GetBucketArchiveDirectReadRequest(
            bucket=args.bucket,  # Nama bucket.
    ))

    # Cetak kode status dan ID permintaan dari hasil operasi untuk mengonfirmasi status permintaan.
    print(f'kode status: {result.status_code},'
          f' ID permintaan: {result.request_id},'
          f' diaktifkan: {result.archive_direct_read_configuration.enabled if hasattr(result.archive_direct_read_configuration, "enabled") else "Tidak diatur"},'  # Apakah akses waktu nyata objek Arsip diaktifkan. Jika tidak diatur, "Tidak diatur" ditampilkan.
    )

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