全部产品
Search
文档中心

Object Storage Service:Membuat bucket menggunakan OSS SDK untuk Python 2.0

更新时间:Aug 26, 2025

Bucket adalah wadah yang digunakan untuk menyimpan objek. Topik ini menjelaskan cara membuat bucket menggunakan Object Storage Service (OSS) SDK untuk Python Versi 2.0.

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. Administrator Akun Alibaba Cloud harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API

Aksi

Definisi

PutBucket

oss:PutBucket

Membuat sebuah bucket.

oss:PutBucketAcl

Setelah membuat bucket, izin ini diperlukan untuk memodifikasi ACL bucket.

Catatan

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

  • Mulai pukul 10:00 (UTC+8) pada tanggal 13 Oktober 2025, OSS akan menerapkan penyesuaian bertahap di semua wilayah untuk mengaktifkan Blokir Akses Publik secara default untuk bucket baru yang dibuat menggunakan API, OSS SDK, atau ossutil. Untuk detail tentang waktu tepat ketika penyesuaian akan berlaku di setiap wilayah, lihat [Pengumuman Resmi] Penyesuaian Konfigurasi Blokir Akses Publik untuk Bucket Baru yang Dibuat. Setelah Blokir Akses Publik diaktifkan, Anda tidak dapat mengonfigurasi izin akses publik, termasuk ACL publik (baca publik dan baca/tulis publik) dan kebijakan bucket yang mengizinkan akses publik. Anda dapat menonaktifkan fitur ini setelah bucket dibuat jika bisnis Anda memerlukan akses publik.

Metode

put_bucket(request: PutBucketRequest, **kwargs) → PutBucketResult

Parameter permintaan

Parameter

Tipe

Deskripsi

request

PutBucketRequest

Parameter permintaan. Untuk informasi lebih lanjut, lihat PutBucketRequest.

Parameter tanggapan

Tipe

Deskripsi

PutBucketResult

Tanggapan terhadap operasi. Untuk informasi lebih lanjut, lihat PutBucketResult.

Untuk detail, lihat put_bucket.

Kode contoh

Berikut adalah kode contoh untuk membuat bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser argumen baris perintah.
parser = argparse.ArgumentParser(description="contoh put bucket")
# Tentukan parameter baris perintah yang diperlukan --region, yang menentukan wilayah tempat bucket berada.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
# Tentukan parameter baris perintah yang diperlukan --bucket, yang menentukan nama bucket.
parser.add_argument('--bucket', help='Nama bucket.', required=True)
# Tentukan parameter baris perintah opsional --endpoint, yang menentukan titik akhir yang dapat digunakan layanan lain untuk mengakses OSS.
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')

def main():
    args = parser.parse_args()  # Parsing parameter baris perintah.

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

    # Muat konfigurasi default SDK dan tentukan penyedia kredensial.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    # Tentukan wilayah tempat bucket berada.
    cfg.region = args.region
    # Jika parameter endpoint disediakan, tentukan titik akhir yang dapat digunakan layanan lain untuk mengakses OSS.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Gunakan konfigurasi untuk membuat instance OSSClient.
    client = oss.Client(cfg)

    # Jalankan permintaan untuk membuat bucket dan atur kelas penyimpanannya ke Standard.
    result = client.put_bucket(oss.PutBucketRequest(
        bucket=args.bucket,
        create_bucket_configuration=oss.CreateBucketConfiguration(
            storage_class='Standard'
        )
    ))
    # Keluarkan kode status HTTP dalam tanggapan dan ID permintaan yang digunakan untuk memeriksa apakah permintaan berhasil.
    print(f'kode status: {result.status_code},'
          f' ID permintaan: {result.request_id},'
    )


if __name__ == "__main__":
    main()  # Titik masuk skrip. Fungsi utama dipanggil saat file dijalankan langsung.

Referensi

  • Untuk kode contoh lengkap untuk membuat bucket, kunjungi put_bucket.py.