全部产品
Search

搜索本产品

    Object Storage Service：GetBucketStat

    文档中心

    Object Storage Service：GetBucketStat

    更新时间：Nov 26, 2025

    Anda dapat memanggil operasi GetBucketStat untuk mendapatkan kapasitas penyimpanan, jumlah objek, dan jumlah bagian multipart pada bucket tertentu.

    Catatan penggunaan

    • Untuk memanggil operasi ini, Anda harus memiliki izin oss:GetBucketStat.

    • Data yang dikembalikan oleh operasi ini tidak real-time dan mungkin mengalami keterlambatan lebih dari satu jam.

    • Informasi penyimpanan yang dikembalikan oleh operasi ini tidak dijamin merupakan informasi terbaru. Nilai LastModifiedTime dalam tanggapan mungkin lebih awal daripada nilai LastModifiedTime dalam tanggapan sebelumnya.

    Sintaksis permintaan

    GET /?stat HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Header permintaan

    Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi selengkapnya, lihat Common request headers.

    Header respons

    Semua header dalam respons terhadap permintaan DescribeRegions merupakan header respons umum. Untuk informasi selengkapnya, lihat Common response headers.

    Elemen respons

    Name

    Tipe

    Contoh

    Deskripsi

    BucketStat

    Container

    N/A

    A container for the BucketStat structure.

    Storage

    Bilangan bulat positif

    1.600

    Kapasitas penyimpanan aktual total bucket tersebut. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    ObjectCount

    Bilangan bulat positif

    230

    Jumlah total objek dalam bucket.

    Parent node: BucketStat

    Child node: None

    MultipartUploadCount

    Bilangan bulat positif

    40

    Jumlah unggah multi-bagian yang telah dimulai tetapi belum diselesaikan atau dibatalkan dalam bucket tersebut.

    Parent node: BucketStat

    Child node: None

    LiveChannelCount

    Bilangan bulat positif

    4

    Jumlah LiveChannels dalam bucket.

    Node induk: BucketStat

    Child node: None

    MultipartPartCount

    Positive integer

    128

    Jumlah bagian multipart yang diunggah ke bucket tersebut.

    Parent node: BucketStat

    Child node: None

    MultipartPartStorage

    Positive integer

    524288000

    Kapasitas penyimpanan bagian multipart yang diunggah ke bucket tersebut. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    DeleteMarkerCount

    Positive integer

    12

    Jumlah penanda hapus dalam bucket tersebut.

    Parent node: BucketStat

    Child node: None

    LastModifiedTime

    Bilangan bulat positif

    1643341269

    Titik waktu informasi penyimpanan yang diperoleh. Nilainya berupa Stempel waktu UNIX dalam satuan detik.

    Parent node: BucketStat

    Child node: None

    StandardStorage

    Bilangan bulat positif

    430

    Kapasitas penyimpanan objek Standard. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    StandardObjectCount

    Bilangan bulat positif

    66

    Jumlah objek Standard.

    Parent node: BucketStat

    Child node: None

    StandardMultipartPartCount

    Positive integer

    10

    Jumlah bagian multipart Standard yang diunggah ke bucket tersebut.

    Parent node: BucketStat

    Child node: None

    StandardMultipartPartStorage

    Positive integer

    104857600

    Kapasitas penyimpanan bagian multipart Standard yang diunggah ke bucket tersebut. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    InfrequentAccessStorage

    Bilangan bulat positif

    2.359.296

    Kapasitas penyimpanan objek Infrequent Access (IA) yang dikenai tagihan. Satuan: byte.

    Penting

    Objek yang ukurannya kurang dari 64 KB dihitung sebagai 64 KB. Untuk informasi selengkapnya mengenai penagihan, lihat Storage fees.

    Parent node: BucketStat

    Child node: None

    InfrequentAccessRealStorage

    Bilangan bulat positif

    360

    Jumlah penyimpanan aktual yang digunakan oleh kelas penyimpanan Infrequent Access, dalam satuan byte.

    Parent node: BucketStat

    Child node: None

    InfrequentAccessObjectCount

    Bilangan bulat positif

    54

    Jumlah objek IA.

    Parent node: BucketStat

    Child node: None

    InfrequentMultipartPartCount

    Positive integer

    10

    Jumlah bagian multipart IA yang diunggah ke bucket tersebut.

    Parent node: BucketStat

    Child node: None

    InfrequentMultipartPartStorage

    Positive integer

    104857600

    Kapasitas penyimpanan bagian multipart IA yang diunggah ke bucket tersebut. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    ArchiveStorage

    Bilangan bulat positif

    2.949.120

    Kapasitas penyimpanan objek Archive yang dikenai tagihan. Satuan: byte.

    Penting

    Objek yang ukurannya kurang dari 64 KB dihitung sebagai 64 KB. Untuk informasi selengkapnya mengenai penagihan, lihat Storage fees.

    Parent node: BucketStat

    Child node: None

    ArchiveRealStorage

    Bilangan bulat positif

    450

    Kapasitas penyimpanan aktual objek Archive. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    ArchiveObjectCount

    Bilangan bulat positif

    74

    Jumlah objek Archive.

    Parent node: BucketStat

    Child node: None

    ArchiveMultipartPartCount

    Positive integer

    10

    Jumlah bagian multipart Archive yang diunggah ke bucket tersebut.

    Parent node: BucketStat

    Child node: None

    ArchiveMultipartPartStorage

    Positive integer

    104857600

    Kapasitas penyimpanan bagian multipart Archive yang diunggah ke bucket tersebut. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    ColdArchiveStorage

    Bilangan bulat positif

    2.359.296

    Kapasitas penyimpanan objek Cold Archive yang dikenai tagihan. Satuan: byte.

    Penting

    Objek yang ukurannya kurang dari 64 KB dihitung sebagai 64 KB. Untuk informasi selengkapnya mengenai penagihan, lihat Storage fees.

    Parent node: BucketStat

    Child node: None

    ColdArchiveRealStorage

    Bilangan bulat positif

    360

    Kapasitas penyimpanan aktual objek Cold Archive. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    ColdArchiveObjectCount

    Bilangan bulat positif

    36

    Jumlah objek Cold Archive.

    Parent node: BucketStat

    Child node: None

    ColdArchiveMultipartPartCount

    Positive integer

    10

    Jumlah bagian multipart Cold Archive yang diunggah ke bucket tersebut.

    Parent node: BucketStat

    Child node: None

    ColdArchiveMultipartPartStorage

    Positive integer

    104857600

    Kapasitas penyimpanan bagian multipart Cold Archive yang diunggah ke bucket tersebut. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    DeepColdArchiveStorage

    Bilangan bulat positif

    2.359.296

    Kapasitas penyimpanan objek Deep Cold Archive yang dikenai tagihan. Satuan: byte.

    Penting

    Objek yang ukurannya kurang dari 64 KB dihitung sebagai 64 KB. Untuk informasi selengkapnya mengenai penagihan, lihat Storage fees.

    Parent node: BucketStat

    Child node: None

    DeepColdArchiveRealStorage

    Bilangan bulat positif

    360

    Kapasitas penyimpanan aktual objek Deep Cold Archive. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    DeepColdArchiveObjectCount

    Bilangan bulat positif

    36

    Jumlah objek Deep Cold Archive.

    Parent node: BucketStat

    Child node: None

    DeepColdArchiveMultipartPartCount

    Positive integer

    10

    Jumlah bagian multipart Deep Cold Archive yang diunggah ke bucket tersebut.

    Parent node: BucketStat

    Child node: None

    DeepColdArchiveMultipartPartStorage

    Positive integer

    104857600

    Kapasitas penyimpanan bagian multipart Deep Cold Archive yang diunggah ke bucket tersebut. Satuan: byte.

    Parent node: BucketStat

    Child node: None

    Contoh

    • Permintaan contoh

      GET /?stat HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:17:29 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • Respons contoh

      <?xml version="1.0" encoding="UTF-8"?>
<BucketStat>
  <Storage>1600</Storage>
  <ObjectCount>230</ObjectCount>
  <MultipartUploadCount>40</MultipartUploadCount>
  <LiveChannelCount>4</LiveChannelCount>
  <LastModifiedTime>1643341269</LastModifiedTime>
  <StandardStorage>430</StandardStorage>
  <StandardObjectCount>66</StandardObjectCount>
  <InfrequentAccessStorage>2359296</InfrequentAccessStorage>
  <InfrequentAccessRealStorage>360</InfrequentAccessRealStorage>
  <InfrequentAccessObjectCount>54</InfrequentAccessObjectCount>
  <ArchiveStorage>2949120</ArchiveStorage>
  <ArchiveRealStorage>450</ArchiveRealStorage>
  <ArchiveObjectCount>74</ArchiveObjectCount>
  <ColdArchiveStorage>2359296</ColdArchiveStorage>
  <ColdArchiveRealStorage>360</ColdArchiveRealStorage>
  <ColdArchiveObjectCount>36</ColdArchiveObjectCount>
</BucketStat>

    SDK

    Kit pengembangan perangkat lunak (SDK) berikut tersedia untuk operasi ini:

    Alat baris perintah ossutil

    Untuk informasi selengkapnya mengenai perintah ossutil untuk operasi GetBucketStat, lihat get-bucket-stat.

    Kode error

    Error code

    HTTP status code

    Description

    AccessDenied

    403

    Anda tidak memiliki izin untuk melihat informasi kapasitas penyimpanan bucket tersebut. Hanya Pemilik bucket yang dapat melihat informasi ini.