更新时间:2024-01-02 GMT+08:00

设置桶配额

功能介绍

桶空间配额值必须为非负整数,单位为Byte(字节),能设的最大值为263-1。桶的默认配额为0,表示没有限制桶配额。

  1. 桶配额设置后,如果想取消配额限制,可以把配额设置为0。
  2. 由于桶配额的校验依赖于桶存量,而桶存量是后台计算,因此桶配额可能不会及时生效,存在滞后性。可能会出现桶存量超出配额或者删除数据后存量未能及时回落的情况。
  3. 桶存量查询接口请参见获取桶存量信息
  4. 桶存量超出配额后再上传对象,会返回HTTP状态码403 Forbidden,错误码InsufficientStorageSpace。请扩大配额,或取消配额限制(设置为0),或删除不需要的对象。

请求消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
PUT /?quota HTTP/1.1 
Host: bucketname.obs.region.example.com
Date: date
Content-Length: length
Authorization: authorization

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<Quota xmlns="http://obs.region.example.com/doc/2015-06-30/">
    <StorageQuota>value</StorageQuota> 
</Quota>

请求消息参数

该请求在请求消息中没有带有参数。

请求消息头

该请求没有特殊的请求消息头,公共部分参见表3

请求消息元素

该操作需要附加请求消息元素来指定桶的空间配额,具体见表1

表1 附加请求消息元素

元素名称

描述

是否必选

StorageQuota

指定桶空间配额值单位为字节。

类型:Integer

响应消息样式

1
2
3
HTTP/1.1 status_code
Date: date
Content-Length: length

响应消息头

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

响应消息元素

该请求的响应中不带有响应元素。

错误响应消息

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

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
PUT /?quota HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 03:24:37 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:k/rbwnYaqYf0Ae6F0M3OJQ0dmI8=
Content-Length: 106

<Quota xmlns="http://obs.region.example.com/doc/2015-06-30/">
  <StorageQuota>10240000</StorageQuota>
</Quota>

响应示例

1
2
3
4
5
6
7
HTTP/1.1 100 Continue
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435E09A2BCA388688AA08
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSHbmBecv7ohDSvqaRObpxzgzJ9+l8xT
Date: WED, 01 Jul 2015 03:24:37 GMT
Content-Length: 0