Obtaining Details of API Versions

Function

This API is used to query the details of DSS API versions.

URI

GET /

Request

Request parameters
None
Example request
The following example shows how to query all versions of an API.
```
GET https://{endpoint}/
```

Response

Response parameters

Table 1 describes the response parameters.

**Table 1** Response parameters
Parameter	Type	Description
versions	Array	Specifies the API version information.
id	String	Specifies the version ID, for example, v1.
links	Array of objects	Specifies the API URL. For details, see Table 2.
version	String	Specifies the maximum microversion supported by this API.
status	String	Specifies the version status. The value can be as follows: CURRENT: indicates that the version is currently recommended for use. SUPPORTED: indicates that the version is an old version, but is still supported. DEPRECATED: indicates a deprecated version which may be deleted later.
updated	String	Specifies the time when the API version was released. Time format: UTC YYYY-MM-DDTHH:MM:SS
min_version	String	Specifies the minimum microversion supported by this API.

Parameters in the links field

Table 2 describes the parameters in the links field.

**Table 2** Parameter description
Parameter	Type	Description
rel	String	Specifies the link description.
href	String	Specifies the version query link.

Example response

{
    "versions": [
        {
            "min_version": "", 
             "links": [
                {
                    "rel": "self", 
                    "href": "https://dss.localdomain.com/v1"
                }
            ], 
            "id": "v1", 
            "updated": "2014-06-28T12:20:21Z", 
            "version": "", 
            "status": "SUPPORTED"
        }, 
        {
            "min_version": "", 
            "links": [
               {
                    "rel": "self", 
                    "href": "https://dss.localdomain.com/v2"
                }
            ], 
            "id": "v2", 
            "updated": "2014-06-28T12:20:21Z", 
            "version": "", 
            "status": "CURRENT"
        }
    ]
}