GET operations against a storage container name are performed to retrieve a list of objects stored in the container. Additionally, there are a number of optional query parameters that can be used to refine the list results.
A request with no query parameters will return the full list of object names stored in the container, up to 10,000 names. Optionally specifying the query parameters will filter the full list and return a subset of objects.
Query Parameters
limitFor an integer value n, limits the number of results to at most n values.
markerGiven a string value x, return object names greater in value than the specified marker.
prefixFor a string value x, causes the results to be limited to object names beginning with the substring x.
formatSpecify either
jsonorxmlto return the respective serialized response.pathFor a string value x, return the object names nested in the pseudo path (assuming preconditions are met - see below).
delimiterFor a character c, return all the object names nested in the container (without the need for the directory marker objects).
Example 3.12. Objects List Request
GET /<api version>/<account>/<container>[?parm=value] HTTP/1.1
Host: storage.swiftdrive.com
X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb
A list of objects is returned in the response body, one object name per line. A 204 (No Content) HTTP return code will be passed back if the container is empty or does not exist for the specified account. If an incorrect account is specified, the HTTP return code will be 404 (Not Found).
Example 3.13. Objects List Response
HTTP/1.1 200 Ok
Date: Thu, 07 Jun 2010 18:50:19 GMT
Server: Apache
Content-Type: text/plain; charset=UTF-8
Content-Length: 171
kate_beckinsale.jpg
How To Win Friends And Influence People.pdf
moms_birthday.jpg
poodle_strut.mov
Disturbed - Down With The Sickness.mp3
army_of_darkness.avi
the_mad.avi
