PowerScale OneFS API Reference

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.

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

Willkommen

Willkommen bei Dell

PowerScale OneFS API Reference

API versions in OneFS

Diesen Inhalt bewerten