Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

PowerScale OneFS API Reference

PDF

API versions in OneFS

OneFS provides version control of API resources.

To use the latest API version, retrieve the latest API version at the URI /platform/latest. In OneFS 9.3.0.0, the API version is 14.

In OneFS 9.3.0.0, you can access the latest version of any configuration API resource at:

/platform/14/<path-to-resource>

Where resources have older versions, the older versions can be accessed at:

/platform/<version>/<path-to-resource>

The functionality of each resource is preserved, even with subsequent API versions. For example, if /resource/x is introduced in API version 1, updated in API version 3, and then updated again in API version 8, the following URI-to-resource mapping applies:

/platform/1/resource/x  ->  resource from API version 1
/platform/2/resource/x  ->  resource from API version 1
/platform/3/resource/x  ->  resource from API version 3
/platform/4/resource/x  ->  resource from API version 3
/platform/5/resource/x  ->  resource from API version 3
/platform/8/resource/x  ->  resource from API version 8

You are guaranteed that when you write code to a specific resource version, that behavior continues to function even if subsequent API versions are released.

These are the OneFS API versions and their corresponding releases:
OneFS version API version
9.3.0.0 14
9.2.1.0 13
9.2.0.0 12
9.1.0.0 11
9.0.0.0 10
8.2.2 9
8.2.1 8
8.2 7
8.1.1 6
8.1 5
8.0.1 4
8.0 3

In future OneFS releases, when the configuration API version is incremented, the /platform/latest URI returns the latest version number. You are guaranteed to access to the latest version of any resource by using the applicable version number in the resource URI.

Older versions of certain resources might be deprecated in the future. Large changes in the underlying OneFS system and configuration can cause certain fields or sets of fields to no longer be applicable. PowerScale only deprecates resources when necessary. If an old version of a resource can function, it is accessible at its original API version number URI.


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\