Example: Listing the items in a directory

Here's a sample GET request for a container listing that lists the objects that are in the mktg directory and, separately, the subdirectories that are in the mktg directory. The requests uses these query parameters:

prefix=mktg/ - lists only items that start with mktg/

marker=mktg/ - Starts the listing with the item that follows mktg/ by itself

delimiter=/ - Treats items that have a forward slash (/) after mktg/ as having a common prefix

Request with curl command line

curl -i -X GET http://api.hcp.example.com/swift/v1/AUTH_6b6884ebb6f441cfbb7e740f6a927c9e/finance?prefix=mktg&marker=l&delimiter=/" -H "X-Auth-Token: dc5efec8f546455eac974e7bbfd0dd87" -H "Accept: application/xml"

Request headers

GET /swift/v1/AUTH_6b6884ebb6f441cfbb7e740f6a927c9e/finance?prefix=mktg&marker=mktg&delimiter=/" HTTP/1.1
X-Auth-Token: dc5efec8f546455eac974e7bbfd0dd87

Response headers

HTTP/1.1 200 OK
Date: Fri, 31 Oct 2014 16:41:58 GMT
Server: HCP V7.1.0.353
X-Trans-Id: 2a6d516f-b78b-418b-aea3-12fc86316ad4
X-Container-Object-Count: 2
X-Container-Bytes-Used: 46080
X-Container-Meta-Quota-Bytes: 53687091200
X-Container-Read:
X-Container-Write:
Content-Type: application/xml;charset=UTF-8

Trademarks and Legal Disclaimer

© 2017 Hitachi Data Systems Corporation. All rights reserved.