list_versions Method
Lists previous versions of a file resource.
Syntax
def list_versions(file_id: str) -> None: ...
Remarks
This method lists previous versions of the file resource specified by FileId. The current version is not included in the results.
Calling this method will fire the on_resource_list event once for each file version, and will also populate the Resource* properties.
If there are still more file versions available to list when this method returns, the version_marker property will be populated. Continue to call this method until version_marker is empty to accumulate all pages of results in the Resource* properties.
Note that Box only returns certain resource details when listing file versions; this is a limitation of the Box API that cannot be changed. Specifically, the following properties are returned:
- resource_created_time
- resource_hash
- resource_id (populated by the class for convenience)
- resource_modified_by
- resource_modified_time
- resource_name
- resource_size
- resource_type (always 0 (brtFile))
- resource_version_id
The MaxResults configuration setting can be used to control the maximum number of results to return at once.
Note that Box only tracks file versions for paid accounts.
// ResourceList event handler. box.OnResourceList += (s, e) => { Console.WriteLine(e.Name + ", Version: " + e.VersionId); }; do { box.ListVersions("f:09876"); for (int i = 0; i < box.Resources.Count; i++) { // Process resource versions here. } } while (!string.IsNullOrEmpty(box.VersionMarker));