更新时间:2024-03-05 GMT+08:00

获取桶存量信息

功能介绍

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

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

请求消息样式

1
2
3
4
GET /?storageinfo HTTP/1.1 
Host: bucketname.obs.region.example.com
Date: date
Authorization: authorization

请求消息参数

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

请求消息头

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

请求消息元素

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

响应消息样式

1
2
3
4
5
6
7
8
9
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.region.example.com/doc/2015-06-30/">
<Size>size</Size> 
<ObjectNumber>number</ObjectNumber> 
</GetBucketStorageInfoResult>

响应消息头

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

响应消息元素

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

表1 响应消息元素

元素名称

描述

GetBucketStorageInfoResult

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

类型:XML

Size

返回存量大小。

类型:Long

ObjectNumber

返回对象个数。

类型:Integer

错误响应消息

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

请求示例

1
2
3
4
5
6
GET /?storageinfo HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.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
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.example.com/doc/2015-06-30/">
  <Size>25490</Size>
  <ObjectNumber>24</ObjectNumber>
</GetBucketStorageInfoResult>