18.5.2. Working with Accounts

This section describes the list of operations you can perform at the account level of the URL.

18.5.2.1. Displaying Container Information

You can list the objects of a specific container, or all containers, as needed using GET command. You can use the following optional parameters with GET request to refine the results:

Table 18.9.  Parameters - Container Information

Parameter Description
limit Limits the number of results to nth value.
marker Returns object names greater in value than the specified marker.
format Specify either JSON or XML to return the respective serialized response.

To display container information
  • List all the containers of an account using the following command: 
    GET /<apiversion>/<account> HTTP/1.1
Host: <storage URL>
X-Auth-Token: <authentication-token-key>
    For example, 
    GET /v1/AUTH_test HTTP/1.1
Host: example.storage.com
X-Auth-Token: AUTH_tkd3ad38b087b49bbbac0494f7600a554

HTTP/1.1 200 Ok
Date: Wed, 13 Jul 2011 16:32:21 GMT
Server: Apache
Content-Type: text/plain; charset=UTF-8
Content-Length: 39

songs
movies
documents
reports
To display container information using cURL (for the above example), run the following command: 
curl -v -X GET -H 'X-Auth-Token: AUTH_tkde3ad38b087b49bbbac0494f7600a554'
https://example.storage.com:443/v1/AUTH_test -k