Topik ini menjelaskan cara mengkueri kapasitas penyimpanan bucket yang ditentukan, serta jumlah dan kapasitas penyimpanan objek untuk berbagai kelas penyimpanan di dalam bucket.
Catatan penggunaan
Kode contoh dalam topik ini menggunakan ID wilayah
cn-hangzhoudari Wilayah (Hangzhou) Tiongkok. Secara default, titik akhir publik digunakan untuk mengakses sumber daya di bucket. Jika Anda ingin mengakses sumber daya di bucket dengan menggunakan layanan Alibaba Cloud lainnya di wilayah yang sama dengan lokasi bucket, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang wilayah dan titik akhir yang didukung oleh OSS, lihat Wilayah dan Titik Akhir OSS.
Definisi metode
get_bucket_stat(request: GetBucketStatRequest, **kwargs) → GetBucketStatResultParameter permintaan
Parameter | Tipe | Deskripsi |
request | GetBucketStatRequest | Parameter permintaan. Untuk informasi lebih lanjut, lihat GetBucketStatRequest |
Parameter respons
Tipe | Deskripsi |
GetBucketStatResult | Parameter respons. Untuk informasi lebih lanjut, lihat GetBucketStatResult |
Untuk definisi metode lengkapnya, lihat get_bucket_stat.
Kode contoh
Anda dapat menggunakan kode berikut untuk mengkueri kapasitas penyimpanan bucket.
import argparse
import alibabacloud_oss_v2 as oss
# Buat parser argumen baris perintah untuk mendeskripsikan bahwa skrip ini digunakan untuk mendapatkan informasi statistik tentang bucket tertentu.
parser = argparse.ArgumentParser(description="Dapatkan informasi statistik tentang bucket OSS tertentu.")
# Tambahkan argumen baris perintah --region, yang menentukan wilayah tempat bucket berada. Argumen ini wajib.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
# Tambahkan argumen baris perintah --bucket, yang menentukan nama bucket untuk mendapatkan statistik. Argumen ini wajib.
parser.add_argument('--bucket', help='Nama bucket untuk mendapatkan statistik.', required=True)
# Tambahkan argumen baris perintah --endpoint, yang menentukan nama domain yang dapat digunakan layanan lain untuk mengakses OSS. Argumen ini opsional.
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS.')
def main():
"""
Fungsi utama, yang digunakan untuk mem-parsing argumen baris perintah dan mendapatkan informasi statistik tentang bucket tertentu.
"""
args = parser.parse_args() # Parsing argumen baris perintah.
# Muat kredensial dari variabel lingkungan untuk verifikasi identitas.
credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
# Gunakan konfigurasi default dari SDK dan atur penyedia kredensial dan informasi wilayah.
cfg = oss.config.load_default()
cfg.credentials_provider = credentials_provider
cfg.region = args.region
# Jika parameter endpoint diberikan, atur endpoint dalam konfigurasi.
if args.endpoint is not None:
cfg.endpoint = args.endpoint
# Buat klien OSS menggunakan informasi yang dikonfigurasi.
client = oss.Client(cfg)
# Konstruksi permintaan untuk mendapatkan informasi statistik tentang bucket tertentu.
request = oss.GetBucketStatRequest(bucket=args.bucket)
# Kirim permintaan dan dapatkan respons.
result = client.get_bucket_stat(request)
# Cetak informasi statistik dalam respons.
print(f'kode status: {result.status_code},'
f' id permintaan: {result.request_id},'
f' penyimpanan: {result.storage},'
f' jumlah objek: {result.object_count},'
f' jumlah unggah multi-bagian: {result.multi_part_upload_count},'
f' jumlah saluran langsung: {result.live_channel_count},'
f' waktu modifikasi terakhir: {result.last_modified_time},'
f' penyimpanan standar: {result.standard_storage},'
f' jumlah objek standar: {result.standard_object_count},'
f' penyimpanan akses jarang: {result.infrequent_access_storage},'
f' penyimpanan nyata akses jarang: {result.infrequent_access_real_storage},'
f' jumlah objek akses jarang: {result.infrequent_access_object_count},'
f' penyimpanan arsip: {result.archive_storage},'
f' penyimpanan nyata arsip: {result.archive_real_storage},'
f' jumlah objek arsip: {result.archive_object_count},'
f' penyimpanan arsip dingin: {result.cold_archive_storage},'
f' penyimpanan nyata arsip dingin: {result.cold_archive_real_storage},'
f' jumlah objek arsip dingin: {result.cold_archive_object_count},'
f' penyimpanan arsip sangat dingin: {result.deep_cold_archive_storage},'
f' penyimpanan nyata arsip sangat dingin: {result.deep_cold_archive_real_storage},'
f' jumlah objek arsip sangat dingin: {result.deep_cold_archive_object_count},'
f' jumlah penanda hapus: {result.delete_marker_count},'
)
if __name__ == "__main__":
main() # Titik masuk skrip. Fungsi utama dipanggil saat file dijalankan secara langsung.Informasi kapasitas penyimpanan umum
Parameter | Deskripsi |
Storage | Total kapasitas penyimpanan bucket. Satuan: byte. |
ObjectCount | Jumlah total objek dalam bucket. |
MultipartUploadCount | Jumlah tugas unggah multi-bagian yang telah dimulai tetapi belum selesai atau dibatalkan di dalam bucket. |
LiveChannelCount | Jumlah LiveChannels di dalam bucket. |
LastModifiedTime | Titik waktu ketika informasi penyimpanan diperoleh oleh pemanggilan ini. Nilainya adalah stempel waktu UNIX. Satuan: detik. |
StandardStorage | Kapasitas penyimpanan objek Standar. Satuan: byte. |
StandardObjectCount | Jumlah objek Standar. |
InfrequentAccessStorage | Kapasitas penyimpanan tagihan objek Akses Jarang (IA). Satuan: byte. |
InfrequentAccessRealStorage | Kapasitas penyimpanan aktual objek IA. Satuan: byte. |
InfrequentAccessObjectCount | Jumlah objek IA. |
ArchiveStorage | Kapasitas penyimpanan tagihan objek Penyimpanan Arsip. Satuan: byte. |
ArchiveRealStorage | Kapasitas penyimpanan aktual objek Penyimpanan Arsip. Satuan: byte. |
ArchiveObjectCount | Jumlah objek Penyimpanan Arsip. |
ColdArchiveStorage | Kapasitas penyimpanan tagihan objek Penyimpanan Arsip Dingin. Satuan: byte. |
ColdArchiveRealStorage | Kapasitas penyimpanan aktual objek Penyimpanan Arsip Dingin. Satuan: byte. |
ColdArchiveObjectCount | Jumlah objek Penyimpanan Arsip Dingin. |
Referensi
Untuk kode contoh lengkapnya, lihat get_bucket_stat.py.