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