GetBucketStat - Object Storage Service - Alibaba Cloud Documentation Center

Queries the storage capacity of a specified bucket and the number of objects that are stored in the bucket.

Usage notes

To call the GetBucketStat operation, you must have the oss:GetBucketStat permission.
Data obtained by calling this operation is not real-time data and may have a latency of over 1 hour.
The time information obtained by calling this operation may not be up-to-date. For example, the value of the LastModifiedTime field obtained by the current GetBucketStat operation may be earlier than the value of this field obtained by the previous GetBucketStat operation.

Request syntax

GET /?stat HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

This request contains only common request headers. For more information, see Common request headers.

Response headers

This request contains only common response headers. For more information, see Common response headers.

Response elements


Element	Type	Example	Description
BucketStat	Container	N/A	The container that stores all elements returned for the GetBucketStat request.
Storage	Positive integer	1600	The storage capacity of the bucket. Unit: bytes. Parent node: BucketStat Child nodes: none
ObjectCount	Positive integer	230	The total number of objects that are stored in the bucket. Parent node: BucketStat Child nodes: none
MultipartUploadCount	Positive integer	40	The number of multipart upload tasks that have been initiated but are not completed or canceled. Parent node: BucketStat Child nodes: none
LiveChannelCount	Positive integer	4	The number of LiveChannels in the bucket. Parent node: BucketStat Child nodes: none
LastModifiedTime	Positive integer	1643341269	The time when the obtained information is last modified. The value of this element is a UNIX timestamp. Unit: seconds. Parent node: BucketStat Child nodes: none
StandardStorage	Positive integer	430	The storage usage of Standard objects in the bucket. Unit: bytes. Parent node: BucketStat Child nodes: none
StandardObjectCount	Positive integer	66	The number of Standard objects in the bucket. Parent node: BucketStat Child nodes: none
InfrequentAccessStorage	Positive integer	2359296	The billed storage usage of Infrequent Access (IA) objects in the bucket. Unit: bytes. Important IA objects that are smaller than 64 KB in size are billed as 64 KB. For more information about billing details, see Storage fees. Parent node: BucketStat Child nodes: none
InfrequentAccessRealStorage	Positive integer	360	The actual storage usage of IA objects in the bucket. Unit: bytes. Parent node: BucketStat Child nodes: none
InfrequentAccessObjectCount	Positive integer	54	The number of IA objects in the bucket. Parent node: BucketStat Child nodes: none
ArchiveStorage	Positive integer	2949120	The billed storage usage of Archive objects in the bucket. Unit: bytes. Important Archive objects that are smaller than 64 KB in size are billed as 64 KB. For more information about billing details, see Storage fees. Parent node: BucketStat Child nodes: none
ArchiveRealStorage	Positive integer	450	The actual storage usage of Archive objects in the bucket. Unit: bytes. Parent node: BucketStat Child nodes: none
ArchiveObjectCount	Positive integer	74	The number of Archive objects in the bucket. Parent node: BucketStat Child nodes: none
ColdArchiveStorage	Positive integer	2359296	The billed storage usage of Cold Archive objects in the bucket. Unit: bytes. Important Cold Archive objects that are smaller than 64 KB in size are billed as 64 KB. For more information about billing details, see Storage fees. Parent node: BucketStat Child nodes: none
ColdArchiveRealStorage	Positive integer	360	The actual storage usage of Cold Archive objects in the bucket. Unit: bytes. Parent node: BucketStat Child nodes: none
ColdArchiveObjectCount	Positive integer	36	The number of Cold Archive objects in the bucket. Parent node: BucketStat Child nodes: none

Examples

Sample requests

GET /?stat HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 28 Dec 2021 01:17:29 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3****

Sample responses

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