Bucket adalah kontainer yang digunakan untuk menyimpan objek. Topik ini menjelaskan cara menanyakan informasi tentang sebuah bucket.
Catatan penggunaan
Dalam topik ini, titik akhir publik Wilayah Tiongkok (Hangzhou) digunakan. Jika Anda 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 Mengonfigurasi Kredensial Akses Menggunakan OSS SDK untuk Python 1.0.
Dalam topik ini, instans OSSClient dibuat menggunakan titik akhir OSS. Jika Anda ingin membuat instans OSSClient menggunakan nama domain kustom atau Layanan Token Keamanan (STS), lihat Inisialisasi.
Untuk menanyakan informasi tentang sebuah bucket, Anda harus memiliki izin
oss:GetBucketInfo. Untuk informasi lebih lanjut, lihat Melampirkan Kebijakan Kustom ke Pengguna RAM.
Contoh
Kode berikut memberikan contoh cara menanyakan informasi tentang sebuah bucket, seperti wilayah dan tanggal pembuatannya.
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan bahwa variabel lingkungan telah dikonfigurasi.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (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"
# Tentukan nama bucket.
bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region)
# Menanyakan informasi tentang bucket.
bucket_info = bucket.get_bucket_info()
# Menanyakan nama bucket.
print("nama: " + bucket_info.name)
# Menanyakan kelas penyimpanan bucket.
print("kelas penyimpanan: " + bucket_info.storage_class)
# Menanyakan waktu pembuatan bucket.
print("tanggal pembuatan: " + bucket_info.creation_date)
# Menanyakan titik akhir internal bucket.
print("titik akhir intranet: " + bucket_info.intranet_endpoint)
# Menanyakan titik akhir publik bucket.
print("titik akhir ekstranet " + bucket_info.extranet_endpoint)
# Menanyakan pemilik bucket.
print("pemilik: " + bucket_info.owner.id)
# Menanyakan daftar kontrol akses (ACL) bucket.
print("izin: " + bucket_info.acl.grant)
# Menanyakan jenis redundansi bucket.
print("jenis redundansi data:" + bucket_info.data_redundancy_type)
# Menanyakan status pelacakan akses bucket. Hanya OSS SDK untuk Python 2.16.1 dan versi lebih baru yang memungkinkan Anda menanyakan status pelacakan akses.
print("pelacakan akses:" + bucket_info.access_monitor)
Referensi
Untuk kode contoh lengkap yang digunakan untuk menanyakan informasi tentang sebuah bucket, kunjungi GitHub.
Untuk informasi lebih lanjut tentang operasi API yang dapat Anda panggil untuk menanyakan informasi tentang sebuah bucket, lihat GetBucketInfo.