GetBucketStat
調(diào)用GetBucketStat接口獲取指定存儲(chǔ)空間(Bucket)的存儲(chǔ)容量以及文件(Object)數(shù)量。
注意事項(xiàng)
調(diào)用該接口時(shí)需要擁有
oss:GetBucketStat
權(quán)限。調(diào)用該接口獲取的數(shù)據(jù)并非是實(shí)時(shí)數(shù)據(jù),延時(shí)可能超過一個(gè)小時(shí)。
調(diào)用該接口獲取到的存儲(chǔ)信息的時(shí)間點(diǎn)不保證是最新的,即后一次調(diào)用該接口返回的LastModifiedTime字段值可能比前一次調(diào)用該接口返回的LastModifiedTime字段值小。
請(qǐng)求語法
GET /?stat HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
請(qǐng)求頭
此接口僅涉及公共請(qǐng)求頭。更多信息,請(qǐng)參見公共請(qǐng)求頭(Common Request Headers)。
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息,請(qǐng)參見公共響應(yīng)頭(Common Response Headers)。
響應(yīng)元素
名稱 | 類型 | 示例值 | 說明 |
BucketStat | 容器 | 不涉及 | BucketStat結(jié)構(gòu)的容器。 |
Storage | 正整數(shù) | 1600 | Bucket總的實(shí)際存儲(chǔ)量,單位字節(jié)。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
ObjectCount | 正整數(shù) | 230 | Bucket中總的Object數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
MultipartUploadCount | 正整數(shù) | 40 | Bucket中已經(jīng)初始化但還未完成(Complete)或者還未中止(Abort)的Multipart Upload數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
LiveChannelCount | 正整數(shù) | 4 | Bucket中Live Channel的數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
LastModifiedTime | 正整數(shù) | 1643341269 | 獲取到的存儲(chǔ)信息的時(shí)間點(diǎn),格式為時(shí)間戳,單位為秒。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
StandardStorage | 正整數(shù) | 430 | 標(biāo)準(zhǔn)存儲(chǔ)類型的存儲(chǔ)量,單位字節(jié)。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
StandardObjectCount | 正整數(shù) | 66 | 標(biāo)準(zhǔn)存儲(chǔ)類型的Object數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
InfrequentAccessStorage | 正整數(shù) | 2359296 | 低頻存儲(chǔ)類型的計(jì)費(fèi)存儲(chǔ)量,單位字節(jié)。 重要 單個(gè)不足64 KB的Object,以64 KB計(jì)算。計(jì)費(fèi)詳情,請(qǐng)參見存儲(chǔ)費(fèi)用。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
InfrequentAccessRealStorage | 正整數(shù) | 360 | 低頻存儲(chǔ)類型的實(shí)際存儲(chǔ)量,單位字節(jié)。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
InfrequentAccessObjectCount | 正整數(shù) | 54 | 低頻存儲(chǔ)類型的Object數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
ArchiveStorage | 正整數(shù) | 2949120 | 歸檔存儲(chǔ)類型的計(jì)費(fèi)存儲(chǔ)量,單位字節(jié)。 重要 單個(gè)不足64 KB的Object,以64 KB計(jì)算。計(jì)費(fèi)詳情,請(qǐng)參見存儲(chǔ)費(fèi)用。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
ArchiveRealStorage | 正整數(shù) | 450 | 歸檔存儲(chǔ)類型的實(shí)際存儲(chǔ)量,單位字節(jié)。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
ArchiveObjectCount | 正整數(shù) | 74 | 歸檔存儲(chǔ)類型的Object數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
ColdArchiveStorage | 正整數(shù) | 2359296 | 冷歸檔存儲(chǔ)類型的計(jì)費(fèi)存儲(chǔ)量,單位字節(jié)。 重要 單個(gè)不足64 KB的Object,以64 KB計(jì)算。計(jì)費(fèi)詳情,請(qǐng)參見存儲(chǔ)費(fèi)用。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
ColdArchiveRealStorage | 正整數(shù) | 360 | 冷歸檔存儲(chǔ)類型的實(shí)際存儲(chǔ)量,單位字節(jié)。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
ColdArchiveObjectCount | 正整數(shù) | 36 | 冷歸檔存儲(chǔ)類型的Object數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
DeepColdArchiveStorage | 正整數(shù) | 2359296 | 深度冷歸檔存儲(chǔ)類型的計(jì)費(fèi)存儲(chǔ)量,單位字節(jié)。 重要 單個(gè)不足64 KB的Object,以64 KB計(jì)算。計(jì)費(fèi)詳情,請(qǐng)參見存儲(chǔ)費(fèi)用。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
DeepColdArchiveRealStorage | 正整數(shù) | 360 | 深度冷歸檔存儲(chǔ)類型的實(shí)際存儲(chǔ)量,單位字節(jié)。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
DeepColdArchiveObjectCount | 正整數(shù) | 36 | 深度冷歸檔存儲(chǔ)類型的Object數(shù)量。 父節(jié)點(diǎn):BucketStat 子節(jié)點(diǎn):無 |
示例
請(qǐng)求示例
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>