Bucket adalah wadah untuk menyimpan objek di Object Storage Service (OSS). Topik ini menjelaskan cara membuat bucket menggunakan OSS SDK untuk Python V1.
Catatan penggunaan
Contoh berikut menggunakan wilayah China (Hangzhou) (
cn-hangzhou) dan titik akhir publik. Untuk mengakses OSS dari Produk Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk pemetaan titik akhir berdasarkan wilayah, lihat Wilayah dan titik akhir.Mulai 13 Oktober 2025 pukul 10.00 (UTC+8), OSS secara default mengaktifkan fitur Block Public Access untuk bucket baru yang dibuat melalui API, OSS SDK, atau ossutil. Peluncuran dilakukan secara bertahap di berbagai wilayah—jadwal lengkap tersedia di [Pengumuman Resmi] Penyesuaian konfigurasi pemblokiran akses publik untuk bucket yang baru dibuat. Saat Block Public Access diaktifkan, Anda tidak dapat mengatur ACL publik (baca publik atau baca/tulis publik) maupun kebijakan bucket yang mengizinkan akses publik. Nonaktifkan fitur ini setelah bucket dibuat jika kasus penggunaan Anda memerlukan akses publik.
Prasyarat
Sebelum memulai, pastikan Anda telah:
Menginstal OSS SDK untuk Python V1 (
oss2)Membuat RAM user untuk akses API atau operasi & pemeliharaan (O&M) rutin serta memiliki ID AccessKey dan AccessKey Secret-nya
AccessKey Akun Alibaba Cloud memiliki izin penuh untuk semua operasi API, yang menimbulkan risiko keamanan. Gunakan AccessKey RAM user untuk akses API sebagai gantinya. Untuk membuat RAM user, masuk ke Konsol RAM.
Buat bucket
Contoh berikut membuat bucket bernama examplebucket dengan pengaturan default.
# -*- coding: utf-8 -*-
import oss2
# AccessKey Akun Alibaba Cloud memiliki izin penuh untuk semua operasi API, yang menimbulkan risiko keamanan.
# Gunakan AccessKey RAM user untuk akses API atau operasi & pemeliharaan (O&M) rutin. Untuk membuat RAM user, masuk ke Konsol RAM.
auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
# Format endpoint: https://oss-{region-id}.aliyuncs.com
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Buat bucket.
bucket.create_bucket()Buat bucket dengan pengaturan khusus
Untuk menentukan kelas penyimpanan, ACL (Access Control List), atau jenis redundansi data saat pembuatan, berikan objek BucketCreateConfig.
Contoh berikut membuat bucket dengan penyimpanan Standard, ACL private, dan penyimpanan redundan zona (ZRS).
# -*- coding: utf-8 -*-
import oss2
auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
bucket_config = oss2.models.BucketCreateConfig(
oss2.BUCKET_STORAGE_CLASS_STANDARD,
oss2.BUCKET_DATA_REDUNDANCY_TYPE_ZRS
)
bucket.create_bucket(oss2.BUCKET_ACL_PRIVATE, bucket_config)Nilai yang didukung untuk setiap parameter adalah:
| Parameter | Konstanta | Nilai |
|---|---|---|
| Kelas penyimpanan | oss2.BUCKET_STORAGE_CLASS_STANDARD | Standard |
| ACL | oss2.BUCKET_ACL_PRIVATE | private |
| Jenis redundansi data | oss2.BUCKET_DATA_REDUNDANCY_TYPE_ZRS | Zone-redundant storage (ZRS) |
Langkah berikutnya
Untuk kode contoh lengkap, lihat contoh di GitHub.
Untuk operasi API yang mendasarinya, lihat PutBucket.