調用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 子節點:無 |
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: Tue, 28 Dec 2021 01:17:29 GMT Authorization: OSS qn6q**************:77Dv****************
返回樣本
<?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>