Object Storage Service：Akselerasi transfer (Python SDK V2)

Berikut adalah kode contoh untuk mengaktifkan fitur akselerasi transfer pada sebuah bucket:

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser argumen baris perintah dan jelaskan tujuan dari skrip: atur konfigurasi akselerasi transfer untuk sebuah bucket.
parser = argparse.ArgumentParser(description="contoh put bucket transfer acceleration")

# Definisikan argumen baris perintah, termasuk wilayah, nama bucket, endpoint yang diperlukan, dan apakah akselerasi transfer diaktifkan.
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='Apakah akselerasi transfer diaktifkan untuk bucket ini. Defaultnya adalah False.', default=False, type=bool)

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 menggunakan konfigurasi di atas untuk mempersiapkan interaksi dengan OSS.
    client = oss.Client(cfg)

    # Kirim permintaan untuk mengatur konfigurasi akselerasi transfer untuk bucket yang ditentukan.
    result = client.put_bucket_transfer_acceleration(oss.PutBucketTransferAccelerationRequest(
            bucket=args.bucket,  # Nama bucket.
            transfer_acceleration_configuration=oss.TransferAccelerationConfiguration(
                enabled=args.enabled,  # Menentukan apakah akan mengaktifkan akselerasi transfer.
            ),
    ))

    # 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 langsung, panggil fungsi utama untuk mulai memproses logika.
if __name__ == "__main__":
    main()  # Titik masuk skrip, dari mana alur program dimulai.

Berikut adalah kode contoh untuk menanyakan status akselerasi transfer pada sebuah bucket:

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser argumen baris perintah dan jelaskan tujuan dari skrip: dapatkan konfigurasi akselerasi transfer dari sebuah bucket.
parser = argparse.ArgumentParser(description="contoh get bucket transfer acceleration")

# Definisikan 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 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 menggunakan konfigurasi di atas untuk mempersiapkan interaksi dengan OSS.
    client = oss.Client(cfg)

    # Kirim permintaan untuk mendapatkan detail konfigurasi akselerasi transfer untuk bucket yang ditentukan.
    result = client.get_bucket_transfer_acceleration(oss.GetBucketTransferAccelerationRequest(
            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.transfer_acceleration_configuration.enabled if hasattr(result.transfer_acceleration_configuration, "enabled") else "Tidak diatur"},'  # Menentukan apakah akselerasi transfer diaktifkan. Jika tidak diatur, "Tidak diatur" akan ditampilkan.
          )

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