A GET request to the container account URL returns a list of
up to 10,000 objects. You may limit and control this list of
results by using the marker and end_marker
parameters.
Marker tells Cloud Files where to begin your list of objects
and end_marker notes where to end the list. You may use
either of them independently, or together, separated by an &. If
you use them on their own, your list will display up to 10,000 containers.
Note that the marker and end_marker values
should be URL-encoded prior to sending the HTTP request.
You may also use the limit parameter to lower the number
of returned objects.
If the number of returned items equals the limit used (or 10,000 if no limit was given), you may assume there are more object names.
Example 4.32. List Large Number of Objects
For an example, let's use a listing of five object names:
gala
grannysmith
honeycrisp
jonagold
reddelicious
We'll use a limit of two to show how things work:
GET /<api version>/<account>/<container>?limit=2
Host: storage.clouddrive.com
X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb
gala
grannysmith
Since we received two items back, we can assume there are more object names to list. So, we make another request with a marker of the last item returned:
GET /<api version>/<account>/<container>?limit=2&marker=grannysmith
Host: storage.clouddrive.com
X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb
honeycrisp
jonagold
Again we have two items returned; there may be more:
GET /<api version>/<account>/<container>?limit=2&marker=jonagold
Host: storage.clouddrive.com
X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb
reddelicious
Now we received less than the limit number of container names, indicating that we have the complete list.
