调用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正整数1600Bucket的总存储量，单位字节。

父节点：BucketStat

子节点：无

ObjectCount正整数230Bucket中总的Object数量。

父节点：BucketStat

子节点：无

MultipartUploadCount正整数40Bucket中已经初始化但还未完成（Complete）或者还未中止（Abort）的Multipart Upload数量。

父节点：BucketStat

子节点：无

LiveChannelCount正整数4Bucket中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>