全部产品
Search
文档中心

Object Storage Service:Buat bucket

更新时间:Mar 20, 2026

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:

ParameterKonstantaNilai
Kelas penyimpananoss2.BUCKET_STORAGE_CLASS_STANDARDStandard
ACLoss2.BUCKET_ACL_PRIVATEprivate
Jenis redundansi dataoss2.BUCKET_DATA_REDUNDANCY_TYPE_ZRSZone-redundant storage (ZRS)

Langkah berikutnya