调用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 归档存储类型的计费存储量,单位字节。
注意 单个不足64 KB的Object,以64 KB计算。计费详情,请参见存储费用

父节点:BucketStat

子节点:无

ArchiveRealStorage 正整数 450 归档存储类型的实际存储量,单位字节。

父节点:BucketStat

子节点:无

ArchiveObjectCount 正整数 74 归档存储类型的Object数量。

父节点:BucketStat

子节点:无

ColdArchiveStorage 正整数 2359296 冷归档存储类型的计费存储量,单位字节。
注意 单个不足64 KB的Object,以64 KB计算。计费详情,请参见存储费用

父节点:BucketStat

子节点:无

ColdArchiveRealStorage 正整数 360 冷归档存储类型的实际存储量,单位字节。

父节点:BucketStat

子节点:无

ColdArchiveObjectCount 正整数 36 冷归档存储类型的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 qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3****
  • 返回示例
    <?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>