調用GetBucketStat介面擷取指定儲存空間Bucket的儲存容量以及檔案Object數量 - Object Storage Service

調用GetBucketStat介面擷取指定儲存空間（Bucket）的儲存容量以及檔案（Object）數量。

注意事項

調用該介面時需要擁有oss:GetBucketStat許可權。
調用該介面擷取的資料並非是即時資料，延時可能超過一個小時。
調用該介面擷取到的儲存資訊的時間點不保證是最新的，即後一次調用該介面返回的LastModifiedTime欄位值可能比前一次調用該介面返回的LastModifiedTime欄位值小。

請求文法

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

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

名稱	類型	樣本值	說明
BucketStat	容器	不涉及	BucketStat結構的容器。
Storage	正整數	1600	Bucket總的實際儲存量，單位位元組。父節點：BucketStat 子節點：無
ObjectCount	正整數	230	Bucket中總的Object數量。父節點：BucketStat 子節點：無
MultipartUploadCount	正整數	40	Bucket中已經初始化但還未完成（Complete）或者還未中止（Abort）的Multipart Upload數量。父節點：BucketStat 子節點：無
LiveChannelCount	正整數	4	Bucket中Live Channel的數量。父節點：BucketStat 子節點：無
MultipartPartCount	正整數	128	Bucket 中上傳的 Multipart 分區的數量。父節點：BucketStat 子節點：無
DeleteMarkerCount	正整數	12	Bucket 中刪除標記的數量。父節點：BucketStat 子節點：無
LastModifiedTime	正整數	1643341269	擷取到的儲存資訊的時間點，格式為時間戳記，單位為秒。父節點：BucketStat 子節點：無
StandardStorage	正整數	430	標準儲存類型的儲存量，單位位元組。父節點：BucketStat 子節點：無
StandardObjectCount	正整數	66	標準儲存類型的Object數量。父節點：BucketStat 子節點：無
InfrequentAccessStorage	正整數	2359296	低頻儲存類型的計費儲存量，單位位元組。重要單個不足64 KB的Object，以64 KB計算。計費詳情，請參見儲存費用。父節點：BucketStat 子節點：無
InfrequentAccessRealStorage	正整數	360	低頻儲存類型的實際儲存量，單位位元組。父節點：BucketStat 子節點：無
InfrequentAccessObjectCount	正整數	54	低頻儲存類型的Object數量。父節點：BucketStat 子節點：無
ArchiveStorage	正整數	2949120	Archive Storage類型的計費儲存量，單位位元組。重要單個不足64 KB的Object，以64 KB計算。計費詳情，請參見儲存費用。父節點：BucketStat 子節點：無
ArchiveRealStorage	正整數	450	Archive Storage類型的實際儲存量，單位位元組。父節點：BucketStat 子節點：無
ArchiveObjectCount	正整數	74	Archive Storage類型的Object數量。父節點：BucketStat 子節點：無
ColdArchiveStorage	正整數	2359296	冷Archive Storage類型的計費儲存量，單位位元組。重要單個不足64 KB的Object，以64 KB計算。計費詳情，請參見儲存費用。父節點：BucketStat 子節點：無
ColdArchiveRealStorage	正整數	360	冷Archive Storage類型的實際儲存量，單位位元組。父節點：BucketStat 子節點：無
ColdArchiveObjectCount	正整數	36	冷Archive Storage類型的Object數量。父節點：BucketStat 子節點：無
DeepColdArchiveStorage	正整數	2359296	深度冷Archive Storage類型的計費儲存量，單位位元組。重要單個不足64 KB的Object，以64 KB計算。計費詳情，請參見儲存費用。父節點：BucketStat 子節點：無
DeepColdArchiveRealStorage	正整數	360	深度冷Archive Storage類型的實際儲存量，單位位元組。父節點：BucketStat 子節點：無
DeepColdArchiveObjectCount	正整數	36	深度冷Archive Storage類型的Object數量。父節點：BucketStat 子節點：無

樣本

請求樣本

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

返回樣本

<?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

此介面所對應的各語言SDK如下：

命令列工具ossutil

GetBucketStat介面所對應的ossutil命令，請參見get-bucket-stat。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
AccessDenied	403	沒有查看Bucket儲存容量資訊的許可權。只有Bucket的擁有者才能查看Bucket的儲存容量資訊。