Querying Bucket Storage Quota
Functions
A bucket owner can query the bucket storage quota, but a bucket owner who is frozen due to arrears cannot. The bucket storage quota is measured by byte. 0 indicates that no upper limit is set.
Request Syntax
GET /?quota HTTP/1.1Host: bucketname.obs.region.example.comDate: dateAuthorization: authorization
Request Parameters
This request contains no message parameters.
Request Headers
This request uses common headers. For details, see Table 3.
Request Elements
This request contains no elements.
Response Syntax
HTTP/1.1 status_codeDate: dateContent-Type: application/xmlContent-Length: length<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Quota xmlns="http://obs.region.example.com/doc/2015-06-30/"><StorageQuota>quota</StorageQuota></Quota>
Response Headers
The response to the request uses common headers. For details, see Table 1.
Response Elements
This response contains elements of information about the bucket quota. Table 1 describes the elements.
Element | Description |
---|---|
Quota | Bucket storage quota. This element contains the StorageQuota element. Type: XML |
StorageQuota | Bucket storage quota quantity. The unit is byte. Type: string |
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request
GET /?quota HTTP/1.1User-Agent: curl/7.29.0Host: examplebucket.obs.region.example.comAccept: */*Date: WED, 01 Jul 2015 03:27:45 GMTAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:8m4bW1gFCNeXQlfu45uO2gpo7l8=
Sample Response
HTTP/1.1 200 OKServer: OBSx-obs-request-id: BF260000016436B55D8DED9AE26C4D18x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSs2Q5vz5AfpAJ/CMNgCfo2hmDowp7M9Content-Type: application/xmlDate: WED, 01 Jul 2015 03:27:45 GMTContent-Length: 150<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Quota xmlns="http://obs.example.com/doc/2015-06-30/"><StorageQuota>0</StorageQuota></Quota>
- Functions
- Request Syntax
- Request Parameters
- Request Headers
- Request Elements
- Response Syntax
- Response Headers
- Response Elements
- Error Responses
- Sample Request
- Sample Response