GET Bucket storage¶
Using this operation, the bucket owner can obtain the bucket's storage information such as the bucket size and number of objects in the bucket. The bucket size is a nonnegative integer, expressed in bytes.
Request Syntax¶
GET /?storageinfo HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization
Request Parameters¶
This request involves no parameters.
Request Headers¶
This request uses common headers. For details about common request headers, see section Common Request Headers.
Request Elements¶
This request involves no elements.
Response Syntax¶
HTTP/1.1 status_code
Server: Server Name
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: id
Content-Type: type
Date: date
Content-Length: length
<Response Body>
Response Headers¶
This response uses common headers. For details about common response headers, see section Common Response Headers.
Response Elements¶
This response involves no elements.
Error Responses¶
No special error responses are returned. For details about error responses, see Table 1.
Sample Request¶
GET /?storageinfo HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept-Encoding: gzip,deflate
Date: Sat, 20 Oct 2012 06:23:16 +0000
Authorization: AWS 08350B985315591007AD:O4jTB/FzS3gXDouwRZgz1wiE2PE=
Sample Response¶
HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 001B21D48A580000013A7CD702AB0011
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: 8NgBZD4YTt+Gi11OlhtdGE/zB1d/q6btnc+L3E5Iq0VU80pf+GtXUfZ9lVmrhU6J
Content-Type: application/xml
Date: Sat, 20 Oct 2012 06:23:16 GMT
Content-Length: 209
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GetBucketStorageInfoResult xmlns="http://obs.example.com/doc/2015-06-30/">
<Size>14960</Size>
<ObjectNumber>11</ObjectNumber>
</GetBucketStorageInfoResult>