文档首页/ 对象存储服务 OBS/ API参考（安卡拉区域）/ API/ 桶的高级配置/ 获取桶存量信息
更新时间：2024-04-15 GMT+08:00
查看PDF
分享

获取桶存量信息

功能介绍

查询桶对象个数及对象占用空间，对象占用空间大小值为非负整数，单位为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>
父主题： 桶的高级配置