Querying All API Versions

Function

Query all available API versions of SWR.

URI

GET /

Request

N/A

Response

Response parameters

Table 1 Response body parameter description

Parameter

Type

Description

versions

Array of objects

A list of objects related to the version. For details, see Table 2.

Table 2 versions parameter description

Parameter

Type

Description

id

String

Version ID (version number), for example, v2.

links

String

API URL. For details, see Table 3.

version

String

If the APIs of this version support microversions, set this parameter to the supported maximum microversion. If the microversion is not supported, leave this parameter blank.

status

String

Version status. The options are as follows:

CURRENT: The version is the primary version.

SUPPORTED: The version is an earlier version, but it is still supported.

DEPRECATED: The version is a deprecated version, which may be deleted later.

updated

String

Version release time, which must be the Coordinated Universal time (UTC) time. For example, the release time of v1 is 2014-06-28T12:20:21Z.

min_version

String

If APIs of this version support microversions, set this parameter to the supported minimum microversion. If the microversion is not supported, leave this parameter blank.

Table 3 links parameter description

Parameter

Type

Description

href

String

Link

rel

String

Description

Response example
{ 
   "versions": [
        {
            "id": "v2",
            "links": 
                {
                    "href": "https://swr-api.xxxx.myhuaweicloud.com/v2/",
                    "rel": "self"
                }
            "min_version": "2.0",
            "status": "CURRENT",
            "updated": "2020-07-09T00:00:00Z",
            "version": "2.26",
        }
    ]

}

Status Code

For details about status code, see Table 4.

Table 4 Status code

Status Code

Description

200

Request successful.

500

Failed to complete the request because of an internal service error.