IPWorks Cloud 2020 Python Edition

Questions / Feedback?

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:

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));

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks Cloud 2020 Python Edition - Version 20.0 [Build 8265]