Enumerating Blob Resources
The Blob service API includes operations for enumerating the containers within an account and the blobs within a container. This topic describes features you can use to enumerate containers and blobs.
An enumeration operation returns a list that contains all or part of the requested list. The operation returns entities in alphabetical order.
You can specify the maximum number of results to be returned in a single call to an enumeration operation. If the maximum number of results is not specified in the request or is greater than 5,000, the server will return up to the maximum of 5,000 items. If you specify a maximum number of results less than or equal to zero, the service returns an error.
The first time an enumeration operation is performed against a particular resource, the response may contain all results, or it may contain a subset of the results and a continuation token. The continuation token can be passed to the subsequent call to return the next set of results, and so on, until the list is complete and no continuation token is returned.
The list of results can be filtered by specifying a prefix string with the request. The list operation returns the entities that have names that begin with that prefix.
You can organize and traverse the blob namespace using a delimiter. The delimiter can be a single character or a string. By default, storage clients use a forward slash character (/) as the delimiter. Storage clients use the delimiter to simulate a hierarchy of directory and blob objects. You can also view a flat list of blobs. In a flat list, the delimiter is a part of the blob name, with no special meaning. A flat listing contains all blobs in a container that match the filtering prefix string. Snapshots only appear in a flat list of blob contents.
ConceptsBlob Service Concepts
Other ResourcesEnumerating Blob Resources (REST API)
Storage Service Versioning