Updated on 2022-12-05 GMT+08:00

Obtaining Service API Versions

Function

This API is used to obtain service API versions. No authentication is required.

URI

GET /

Request Parameters

None

Response Parameters

Status code: 200

Table 1 Response body parameters

Parameter

Type

Description

versions

Array of Version objects

API versions of the service.

Table 2 Version

Parameter

Type

Description

id

String

API version ID, for example, v1.

Minimum: 1

Maximum: 128

version

String

Maximum microversion of the API. This parameter is left blank if the microversion is not supported.

Minimum: 1

Maximum: 128

min_version

String

Minimum microversion of the API. This parameter is left blank if the microversion is not supported.

Minimum: 1

Maximum: 128

status

String

API version status.

  • The options are as follows:

  • CURRENT: recommended version.

  • SUPPORTED: an old version that is still supported.

  • DEPRECATED: deprecated version, which may be deleted later.

updated

Number

UTC time when the API version was released.

Minimum: 1

Maximum: 128

links

Array<Object>

URL of the API version.

Example Requests

None

Example Responses

Status code: 200

OK

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

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.