HCP Tenant Management Help
You use the HTTP GET method to list the contents of a container and its ACLs. To list the contents of a container, you need browse permission for the container.
For the purpose of a container listing, the container contents consist not only of the objects you stored in the container but also of the directories that you created in the container or that HCP created automatically from the object names. For example, by default, if a container contains an object named quarterly_rpts/Q4_2012, a list of the container contents includes these two items:
quarterly_rpts/
quarterly_rpts/Q4_2012
By default, a container listing includes only the current (or only) versions of objects. You cannot request to view older versions of objects using HSwift.
You can use query parameters to list only a subset of the items in a container. For information about using these parameters, see Limiting the container listing.
A container listing is returned in a plain text response body although the format can be changed to either an XML or JSON response body. In the response body, items in the container listing occur in alphanumeric order.
By default, a container listing can include at most 10,000 items. However, you can use the limit query parameter in a request to specify a smaller maximum number of items. If more than the maximum number of items satisfy the criteria for a request, you can resubmit the request using query parameters to retrieve the next part of the listing.
Trademarks and Legal Disclaimer
© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.