S3 supports some "meta" operations for your account.
All requests mentioned here require authentication.
Get Usage Information
Currently, the only service information available is usage statistics for your user. The same request also returns your account limits so you can know how close you are to quota.
This can be done via making a GET
request to /?usage
.
# BEGIN REQUEST #
GET /?usage= HTTP/1.1
Host: us-east1.s3.netfire.com
X-AMZ-Content-SHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
A-AMZ-Date: 20230913T221900Z
Authorization: AWS4-HMAC-SHA256 Credential=88D7KRTO4HXGERCSE4TV/20230913/us-east1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=ea8368a6df75a30148845f73b784f4433da0f9c10a0a2bd9bb6cc4a2f8e80322
User-Agent: python-urllib3/1.26.15
# END REQUEST #
# BEGIN RESPONSE #
HTTP/1.1 200 OK
Transfer-Encoding: chunked
X-AMZ-Request-ID: tx0000016c452c58b1b5697-0065023555-97862c-us-east1
Content-Type: application/xml
Date: Wed, 13 Sep 2023 22:19:01 GMT
Connection: close
## BEGIN RESPONSE BODY ##
<?xml version="1.0" encoding="UTF-8"?><Usage><Entries></Entries><Summary><QuotaMaxBytes>10995116277760</QuotaMaxBytes><QuotaMaxBuckets>96</QuotaMaxBuckets><QuotaMaxObjCount>-1</QuotaMaxObjCount><QuotaMaxBytesPerBucket>-1</QuotaMaxBytesPerBucket><QuotaMaxObjCountPerBucket>-1024</QuotaMaxObjCountPerBucket><TotalBytes>1024005</TotalBytes><TotalBytesRounded>1044480</TotalBytesRounded><TotalEntries>7</TotalEntries></Summary><CapacityUsed><User><Buckets><Entry><Bucket>example</Bucket><Bytes>1024005</Bytes><Bytes_Rounded>1044480</Bytes_Rounded></Entry><Entry><Bucket>example2</Bucket><Bytes>0</Bytes><Bytes_Rounded>0</Bytes_Rounded></Entry></Buckets></User></CapacityUsed></Usage>
## END RESPONSE BODY ##
# END RESPONSE #
"Prettified" response body:
<?xml version="1.0" encoding="UTF-8"?>
<Usage>
<Entries/>
<Summary>
<QuotaMaxBytes>10995116277760</QuotaMaxBytes>
<QuotaMaxBuckets>96</QuotaMaxBuckets>
<QuotaMaxObjCount>-1</QuotaMaxObjCount>
<QuotaMaxBytesPerBucket>-1</QuotaMaxBytesPerBucket>
<QuotaMaxObjCountPerBucket>-1024</QuotaMaxObjCountPerBucket>
<TotalBytes>1024005</TotalBytes>
<TotalBytesRounded>1044480</TotalBytesRounded>
<TotalEntries>7</TotalEntries>
</Summary>
<CapacityUsed>
<User>
<Buckets>
<Entry>
<Bucket>example</Bucket>
<Bytes>1024005</Bytes>
<Bytes_Rounded>1044480</Bytes_Rounded>
</Entry>
<Entry>
<Bucket>example2</Bucket>
<Bytes>0</Bytes>
<Bytes_Rounded>0</Bytes_Rounded>
</Entry>
</Buckets>
</User>
</CapacityUsed>
</Usage>