ColdStack Docs
  • Introduction
  • ColdStack FAQ
  • Binance Smart Chain Bridge
    • Release
    • Customer Support
    • FAQ
    • Step-by-Step Guide
  • Concepts
    • Bucket versioning
    • Logging actions with a bucket
  • Tools
    • Supported tools
      • CyberDuck S3 Client
      • S3 Browser
      • AWS CLI Console client
      • SDKs for different languages
        • JavaScript SDK
        • Using extended API with JavaScript
        • AWS SDK for Java
        • Python SDK (boto)
  • S3 Compatible API
    • How to use the API
    • Signing Requests
    • API Reference
      • Bucket
        • HeadBucket
        • ListObjects/ListObjectsV2
        • PutBucketVersioning
        • PutBucketLogging
        • RenameBucket
        • GetBucketLocation
        • ListBuckets
      • Object
        • PutObject
        • GetObject
        • HeadObject
        • RenameObject
        • PutObjectAcl
      • Multipart upload
        • General multipart upload order
        • CreateMultipartUpload
        • UploadPart
        • CompleteMultipartUpload
        • ListMultipartUploads
      • Analytics
        • GetStatistics
        • GetBandwidthAnalytics
        • GetStorageAnalytics
      • Common request headers
      • Common response headers
      • Responses
Powered by GitBook
On this page
  • Request
  • Response

Was this helpful?

  1. S3 Compatible API
  2. API Reference
  3. Analytics

GetStatistics

PreviousAnalyticsNextGetBandwidthAnalytics

Last updated 3 years ago

Was this helpful?

Returns overall usage statistics.

This operation is an extension to the standard S3 API, and is implemented to provide more information to the about their usage.

Request

GET /?statistics HTTP/1.1

Response

Headings

The response can only contain .

Response codes

For a list of possible answers, see the section .

The successful response contains additional data in XML format, the schema of which is described below.

Data schema

<?xml version="1.0" encoding="UTF-8"?>
<Statistics>
  <BucketsCount>4</BucketsCount>
  <ObjectsCount>12</ObjectsCount>
  <UsedStorage>
    <UsedStorageBytes>271242929</UsedStorageBytes>
    <UsedStorageReadableQuantity>271</UsedStorageReadableQuantity>
    <UsedStorageReadableUnit>MB</UsedStorageReadableUnit>
  </UsedStorage>
  <Bandwidth>
    <BandwidthBytes>271242929</BandwidthBytes>
    <BandwidthReadableQuantity>271</BandwidthReadableQuantity>
    <BandwidthReadableUnit>MB</BandwidthReadableUnit>
  </Bandwidth>
</Statistics>

Element

Description

Statistics

Root element.

BucketsCount

Number of buckets.

ObjectsCount

Overall number of objects in all owned buckets.

UsedStorage

Used disk storage.

UsedStorageBytes

Used storage size represented as bytes.

UsedStorageReadableQuantity

Quantity of used storage readable representation.

UsedStorageReadableUnit

Unit of used storage readable representation.

Bandwidth

Used bandwidth.

BandwidthBytes

Used bandwidth represented as bytes.

BandwidthReadableQuantity

Quantity of used bandwidth readable representation.

BandwidthReadableUnit

Unit of used bandwidth readable representation.

general headers
Answers