Back to Ceph

Service Operations

doc/radosgw/swift/serviceops.rst

21.0.01.4 KB
Original Source

==================== Service Operations

To retrieve data about our Swift-compatible service, you may execute GET requests using the X-Storage-Url value retrieved during authentication.

List Containers

A GET request that specifies the API version and the account will return a list of containers for a particular user account. Since the request returns a particular user's containers, the request requires an authentication token. The request cannot be made anonymously.

Syntax


::

	GET /{api version}/{account} HTTP/1.1
	Host: {fqdn}
	X-Auth-Token: {auth-token}



Request Parameters

limit

:Description: Limits the number of results to the specified value. :Type: Integer :Required: No

format

:Description: Defines the format of the result. :Type: String :Valid Values: json | xml :Required: No

marker

:Description: Returns a list of results greater than the marker value. :Type: String :Required: No

Response Entities


The response contains a list of containers, or returns with an HTTP
204 response code

``account``

:Description: A list for account information.
:Type: Container

``container``

:Description: The list of containers.
:Type: Container

``name``

:Description: The name of a container.
:Type: String

``bytes``

:Description: The size of the container.
:Type: Integer