全部產品
Search
文件中心

:GetBucketStat

更新時間:Jun 19, 2024

調用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>