使用GetBucketStat获取Bucket的存储容量和文件数量-对象存储-阿里云

调用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 子节点：无
MultipartPartCount	正整数	128	Bucket 中上传的 Multipart 分片的数量。父节点：BucketStat 子节点：无
DeleteMarkerCount	正整数	12	Bucket 中删除标记的数量。父节点：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 子节点：无
DeepColdArchiveStorage	正整数	2359296	深度冷归档存储类型的计费存储量，单位字节。重要单个不足64 KB的Object，以64 KB计算。计费详情，请参见存储费用。父节点：BucketStat 子节点：无
DeepColdArchiveRealStorage	正整数	360	深度冷归档存储类型的实际存储量，单位字节。父节点：BucketStat 子节点：无
DeepColdArchiveObjectCount	正整数	36	深度冷归档存储类型的Object数量。父节点：BucketStat 子节点：无

示例

请求示例

GET /?stat HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:17:29 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回示例

<?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>

SDK

此接口所对应的各语言SDK如下：

命令行工具ossutil

GetBucketStat接口所对应的ossutil命令，请参见get-bucket-stat。

错误码

错误码	HTTP状态码	描述
AccessDenied	403	没有查看Bucket存储容量信息的权限。只有Bucket的拥有者才能查看Bucket的存储容量信息。