Object Storage

Get bucket details

Returns details for a specific bucket including usage statistics.

get/v1/object-storage/buckets/{bucket_name}

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/object-storage/buckets/{bucket_name}
  • Auth: HTTP bearer

Path parameters

bucket_namestring required
Example:my-app-uploads

Globally unique bucket name (S3 naming rules apply)

Response

Bucket details

idstring required

Unique identifier of the bucket

namestring required

Globally unique bucket name

object_countnumber

Number of objects stored in the bucket

size_gbnumber

Total size of all objects in GB

created_atstring date-time required

When the bucket was created

Example response

{
  "id": "7dfc2631-0158-4f74-93f6-6b46dcb90fef",
  "name": "my-app-uploads",
  "object_count": 42,
  "size_gb": 1,
  "created_at": "2024-01-15T14:10:27.114Z"
}

Changes

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