全部产品
Search
文档中心

对象存储 OSS:GetBucketStat

更新时间:May 30, 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

归档存储类型的计费存储量,单位字节。

重要

单个不足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>