Swift list containers

Edit online

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: FULLY_QUALIFIED_DOMAIN_NAME
X-Auth-Token: AUTH_TOKEN

Request Parameters

limit

Description: Limits the number of results to the specified value.
Type: Integer
Valid Values: N/A
Required: Yes

format

Description: Limits the number of results to the specified value.
Type: Integer
Valid Values: json or xml
Required: No

marker

Description: Returns a list of results greater than the marker value.
Type: String
Valid Values: N/A
Required: No

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

Response Entities

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