Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Bucket Usage

Get API Usage

Returns the detail on API usage on a bucket of a particular time period, group by method category.

get/storage/buckets/{bucketName}/usage/api

Path parameters

bucketNamestring required

The name of the bucket

Query parameters

end_timestring date-time required

The end time of the period to filter the usage (ISO microsecond format)

start_timestring date-time required

The start time of the period to filter the usage (ISO microsecond format)

Consolidated filter parameter (deepObject style). Originally: filter[start_time], filter[end_time]

Response

Bucket Usage

Example response

{
  "data": [
    {
      "categories": [
        {
          "bytes_received": 123456,
          "bytes_sent": 123456,
          "category": "put_obj",
          "ops": 123456,
          "successful_ops": 123456
        }
      ],
      "timestamp": "2020-01-01T00:00:00Z",
      "total": {
        "bytes_received": 123456,
        "bytes_sent": 123456,
        "ops": 123456,
        "successful_ops": 123456
      }
    }
  ]
}