Since buckets can contain a virtually unlimited number of objects, the complete results of a list query can be extremely large. To manage large result sets, Amazon S3 uses pagination to split them into multiple responses. Callers should always check the IsTruncated to see if the returned listing is complete, or if callers need to make additional calls to get more results. The KeyMarker and VersionIdMarker parameters of the ListVersionsRequest object allow callers to specify where to start the version listing. In order to enable versioning on a bucket, please refer to the SetBucketVersioning operation's details.

List performance is not substantially affected by the total number of keys in your bucket, nor by the presence or absence of any additional query parameters. The ListVersions operation returns a list of object versions in the bucket specified ordered first by key and then by version. Keys are sorted lexicographically (i.e. alphabetically from a-Z); versions are sorted from most to least recent. Both versions with data and delete markers are included in the results.

In order to List Versions, you must have READ access to the bucket. When the list is not filtered by a specific key, only the metadata associated with the latest version of objects in the bucket is returned. The use of KeyMarker and VersionIdMarker allow you to filter results.