调用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: 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>
SDK
此接口所对应的各语言SDK如下：
Java
Python
PHP
Go V2
Node.js
命令行工具ossutil
GetBucketStat接口所对应的ossutil命令，请参见get-bucket-stat。
错误码
错误码 | HTTP状态码 | 描述 |
AccessDenied | 403 | 没有查看Bucket存储容量信息的权限。只有Bucket的拥有者才能查看Bucket的存储容量信息。 |