全部产品
Search
文档中心

Object Storage Service:Daftar bucket menggunakan OSS SDK untuk Python 1.0

更新时间:Aug 16, 2025

Bucket adalah wadah untuk objek yang disimpan dalam Object Storage Service (OSS). Semua objek di OSS berada dalam bucket, yang terdaftar secara alfabetis. Anda dapat mencantumkan bucket dari Akun Alibaba Cloud saat ini di semua Wilayah yang memenuhi kondisi tertentu.

Catatan penggunaan

  • Dalam topik ini, titik akhir publik Wilayah China (Hangzhou) digunakan. Jika ingin mengakses OSS dari layanan Alibaba Cloud lainnya di wilayah yang sama dengan OSS, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang wilayah dan titik akhir OSS, lihat Wilayah dan titik akhir OSS.

  • Dalam topik ini, kredensial akses diperoleh dari variabel lingkungan. Untuk informasi lebih lanjut tentang cara mengonfigurasi kredensial akses, lihat Konfigurasikan kredensial akses menggunakan OSS SDK untuk Python 1.0.

  • Dalam topik ini, instans OSSClient dibuat menggunakan titik akhir OSS. Jika ingin membuat instans OSSClient menggunakan nama domain kustom atau Security Token Service (STS), lihat Inisialisasi.

  • Untuk mencantumkan bucket, Anda harus memiliki izin oss:ListBuckets. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke Pengguna RAM.

Daftarkan semua bucket dalam Akun Alibaba Cloud

Contoh kode berikut menunjukkan cara mencantumkan bucket di semua wilayah dalam Akun Alibaba Cloud saat ini:

Catatan

Kode berikut tidak dapat digunakan untuk mencantumkan bucket di wilayah tertentu. Sebagai contoh, jika wilayah bucket ditentukan sebagai China (Hangzhou), maka bucket di semua wilayah dalam Akun Alibaba Cloud saat ini akan dicantumkan.

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum Anda menjalankan kode contoh, pastikan bahwa variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# Tentukan titik akhir wilayah tempat bucket berada. Sebagai contoh, jika bucket berada di wilayah China (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"

# Tentukan ID wilayah yang sesuai dengan titik akhir. Contoh: cn-hangzhou. Parameter ini diperlukan jika Anda menggunakan algoritma tanda tangan V4.
region = "cn-hangzhou"

service = oss2.Service(auth, endpoint, region=region)

# Daftarkan semua bucket di semua wilayah dalam akun saat ini.
for b in oss2.BucketIterator(service):
    print(b.name)

Daftarkan bucket yang namanya mengandung awalan tertentu

Contoh kode berikut menunjukkan cara mencantumkan bucket dengan awalan contoh di semua wilayah dalam Akun Alibaba Cloud saat ini:

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum Anda menjalankan kode contoh, pastikan bahwa variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# Tentukan titik akhir wilayah tempat bucket berada. Sebagai contoh, jika bucket berada di wilayah China (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"

# Tentukan ID wilayah yang sesuai dengan titik akhir. Contoh: cn-hangzhou. Parameter ini diperlukan jika Anda menggunakan algoritma tanda tangan V4.
region = "cn-hangzhou"

service = oss2.Service(auth, endpoint, region=region)

# Daftarkan semua bucket yang namanya mengandung awalan contoh dalam akun saat ini.
for b in oss2.BucketIterator(service, prefix='example'):
    print(b.name)

Daftarkan bucket yang namanya secara alfabetis setelah bucket yang ditentukan oleh marker

Contoh kode berikut menunjukkan cara mencantumkan bucket yang namanya secara alfabetis setelah bucket bernama examplebucket di semua wilayah dalam Akun Alibaba Cloud saat ini:

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum Anda menjalankan kode contoh, pastikan bahwa variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# Tentukan titik akhir wilayah tempat bucket berada. Sebagai contoh, jika bucket berada di wilayah China (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"

# Tentukan ID wilayah yang sesuai dengan titik akhir. Contoh: cn-hangzhou. Parameter ini diperlukan jika Anda menggunakan algoritma tanda tangan V4.
region = "cn-hangzhou"

service = oss2.Service(auth, endpoint, region=region)

# Daftarkan semua bucket yang namanya secara alfabetis setelah examplebucket di bawah akun saat ini. Bucket bernama examplebucket tidak dicantumkan.
for b in oss2.BucketIterator(service, marker='examplebucket'):
    print(b.name) 

Referensi

  • Untuk kode contoh lengkap yang digunakan untuk mencantumkan bucket, kunjungi GitHub.

  • Untuk informasi lebih lanjut tentang operasi API yang dapat dipanggil untuk mencantumkan bucket, lihat ListBuckets (GetService).