object-storage-2

List bucket metrics

Returns metrics for buckets within a service.

get/1.3/object-storage-2/{service-uuid}/buckets

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/object-storage-2/{service-uuid}/buckets
  • Auth: HTTP bearer

Path parameters

service-uuidstring uuid required

The unique identifier for the service.

Example:01234567-89ab-cdef-0123-456789abcdef

Service UUID

Query parameters

limitinteger

Schema for a query parameter specifying the maximum number of entries to return (limit).

Example:10

Number of entries to receive at most.

offsetinteger

Schema for a query parameter specifying the offset for pagination.

Offset for retrieved results.

Response

OK

namestring
total_objectsinteger
total_size_bytesinteger
deletedboolean

Example response

[
  {
    "name": "my-bucket-1",
    "total_objects": 1000,
    "total_size_bytes": 1073741824
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.