文档首页/ 对象存储服务 OBS/ API参考/ API/ 桶的高级配置/ 获取桶存量信息
更新时间：2024-10-21 GMT+08:00
查看PDF
分享

获取桶存量信息

功能介绍

查询桶对象个数及对象占用空间，对象占用空间大小值为非负整数，单位为Byte（字节）。

由于OBS桶存量是后台统计，因此存量会有一定的时延，不能实时更新，因此不建议对存量做实时校验。

OBS的桶容量API增加对各个存储类型的容量统计，目前仅支持部分区域，请以实际操作为准。

请求消息样式

1
2
3
4
 
GET /?storageinfo HTTP/1.1 
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Date: date
Authorization: authorization

请求消息参数

该请求不使用请求消息参数。

请求消息头

该请求使用公共消息头，具体参见表3。

请求消息元素

该请求消息中不使用请求消息元素。

响应消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
 
HTTP/1.1 status_code
Date: date
Content-Type: type
Content-Length: length
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<GetBucketStorageInfoResult xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> 
<Size>size</Size> 
<ObjectNumber>number</ObjectNumber> 
<StandardSize>standardsize</StandardSize> 
<StandardObjectNumber>standardnumber</StandardObjectNumber>
<WarmSize>warmsize</WarmSize> 
<WarmObjectNumber>warmnumber</WarmObjectNumber> 
<ColdSize>coldsize</ColdSize> 
<ColdObjectNumber>coldnumber</ColdObjectNumber>
<DeepArchiveSize>deepArchiveSize</DeepArchiveSize>
<DeepArchiveObjectNumber>deepArchiveNumber</DeepArchiveObjectNumber>
</GetBucketStorageInfoResult>

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

响应消息元素

该响应中将桶存量信息以消息元素的形式返回，元素的具体含义如表1所示。

表1 响应消息元素

元素名称

描述

GetBucketStorageInfoResult

保存桶存量请求结果，包含存量大小和对象个数。

类型：XML

Size

返回存量大小。

类型：Long

ObjectNumber

返回对象个数。

类型：Integer

StandardSize

返回STANDARD存储类型的存量大小。当无STANDARD存储类型对象时不返回此字段。

类型：Long

StandardObjectNumber

返回STANDARD对象个数。当无STANDARD存储类型对象时不返回此字段。

类型：Integer

WarmSize

返回WARM存储类型的存量大小。当无WARM存储类型对象时不返回此字段。

类型：Long

WarmObjectNumber

返回WARM对象个数。当无WARM存储类型对象时不返回此字段。

类型：Integer

ColdSize

返回COLD存储类型的存量大小。当无COLD存储类型对象时不返回此字段。

类型：Long

ColdObjectNumber

返回COLD对象个数。当无COLD存储类型对象时不返回此字段。

类型：Integer

DeepArchiveSize

返回DEEP_ARCHIVE存储类型的存量大小。当无DEEP_ARCHIVE存储类型对象时不返回此字段。

类型：Long

DeepArchiveObjectNumber

返回DEEP_ARCHIVE对象个数。当无DEEP_ARCHIVE存储类型对象时不返回此字段。

类型：Integer

错误响应消息

无特殊错误，所有错误已经包含在表2中。

请求示例

1
2
3
4
5
6
 
GET /?storageinfo HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 03:31:18 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:bLcdeJGYWw/eEEjMhPZx2MK5R9U=

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435DD2958BFDCDB86B55E
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSitZctaPYVnat49fVMd1O+OWIP1yrg3
Content-Type: application/xml
WED, 01 Jul 2015 03:31:18 GMT
Content-Length: 206

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GetBucketStorageInfoResult xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">
  <Size>25490</Size>
  <ObjectNumber>24</ObjectNumber>
  <StandardSize>25490</StandardSize> 
  <StandardObjectNumber>24</StandardObjectNumber>
</GetBucketStorageInfoResult>
父主题： 桶的高级配置

相关文档