更新时间:2024-01-30 GMT+08:00
分享

获取桶存量信息

功能介绍

查询桶对象个数及对象占用空间,对象占用空间大小值为非负整数,单位为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>
分享:

    相关文档

    相关产品