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