Help Center> Dedicated Distributed Storage Service> API Reference> API Description> Obtaining Details of API Versions
View PDF

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 values 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"
        }
    ]
}

Returned Values

Error Codes

See Error Codes.

Parent topic: API Description