Updated on 2022-09-15 GMT+08:00

Querying version list

Function

This API enables you to querying all API versions.

URI

GET /

Request Parameters

None

Response Parameters

Status code: 200

Table 1 Response body parameters

Parameter

Type

Description

versions

Array of ApiVersionDetail objects

List of all versions.

Table 2 ApiVersionDetail

Parameter

Type

Description

id

String

Version number, for example, v1.0.

links

Array of ApiLink objects

JSON object.

version

String

If the APIs of this version support microversions, the supported maximum microversion is returned. If microversions are not supported, an empty string is returned.

status

String

Version status. It can be:

  • CURRENT: widely used version

  • SUPPORTED: earlier version which is still supported

  • DEPRECATED: deprecated version which may be deleted later

updated

String

Coordinated Universal time (UTC) time when the version was released. For example, the value is 2014-06-28T12:20:21Z for v1.

min_version

String

If the APIs of this version support microversions, the supported minimum microversion is returned. If microversions are not supported, an empty string is returned.

Example Requests

None

Example Responses

Status code: 200

Request processing succeeded.

[ {
  "min_version" : "",
  "links" : [ {
    "rel" : "self",
    "href" : "https://kms.region_id.domain.com/v1.0/"
  } ],
  "id" : "v1.0",
  "version" : "",
  "updated" : "2016-10-29T02:00:00Z",
  "status" : "CURRENT"
} ]

Status Codes

Status Code

Description

200

Request processing succeeded.

Error Codes

See Error Codes.