Service Operations

List Buckets

GET / returns a list of buckets created by the user making the request. GET / only returns buckets created by an authenticated user. You cannot make an anonymous request.

Syntax

::

	GET / HTTP/1.1
	Host: cname.domain.com

	Authorization: AWS {access-key}:{hash-of-header-and-secret}

Response Entities

+----------------------------+-------------+-----------------------------------------------------------------+ | Name | Type | Description | +============================+=============+=================================================================+ | Buckets | Container | Container for list of buckets. | +----------------------------+-------------+-----------------------------------------------------------------+ | Bucket | Container | Container for bucket information. | +----------------------------+-------------+-----------------------------------------------------------------+ | Name | String | Bucket name. | +----------------------------+-------------+-----------------------------------------------------------------+ | CreationDate | Date | UTC time when the bucket was created. | +----------------------------+-------------+-----------------------------------------------------------------+ | ListAllMyBucketsResult | Container | A container for the result. | +----------------------------+-------------+-----------------------------------------------------------------+ | Owner | Container | A container for the bucket owner's ID and DisplayName. | +----------------------------+-------------+-----------------------------------------------------------------+ | ID | String | The bucket owner's ID. | +----------------------------+-------------+-----------------------------------------------------------------+ | DisplayName | String | The bucket owner's display name. | +----------------------------+-------------+-----------------------------------------------------------------+

Get Usage Stats

Gets usage stats per user, similar to the admin command :ref:rgw_user_usage_stats.

Syntax

::

	GET /?usage HTTP/1.1
	Host: cname.domain.com

	Authorization: AWS {access-key}:{hash-of-header-and-secret}

Response Entities

+----------------------------+-------------+-----------------------------------------------------------------+ | Name | Type | Description | +============================+=============+=================================================================+ | Summary | Container | Summary of total stats by user. | +----------------------------+-------------+-----------------------------------------------------------------+ | TotalBytes | Integer | Bytes used by user | +----------------------------+-------------+-----------------------------------------------------------------+ | TotalBytesRounded | Integer | Bytes rounded to the nearest 4k boundary | +----------------------------+-------------+-----------------------------------------------------------------+ | TotalEntries | Integer | Total object entries | +----------------------------+-------------+-----------------------------------------------------------------+