Querying a Specified API Version

Function

This API is used to query the specified API version.

Before calling an API, you need to understand the API in Authentication.

URI

URI format
GET /rds/{version}

Parameter description

**Table 1** Parameter description
Name	Mandatory	Description
version	Yes	Specifies the API version. It is case-sensitive. For details, see id in Table 2 in section Querying API Versions.

Request

Request parameters
None

URI example
GET https://{endpoint}/rds/v1

Response

Normal response

**Table 2** Parameter description
Name	Type	Description
versions	Object	Indicates the list of detailed API version information. For details, see Table 3.
version	Object	Indicates the list of detailed API version information. For details, see Table 3.

**Table 3** versions field data structure description
Name	Type	Description
id	String	Indicates the API version.
links	Array	Indicates the API version link information. Its value is empty. For details, see Table 4.
status	String	Indicates the version status.
updated	String	Indicates the version update time in the "yyyy-mm-dd Thh:mm:ssZ" format. T is the separator between the calendar and the hourly notation of time. Z indicates the UTC.

**Table 4** links field data structure description
Name	Type	Description
href	String	Indicates the API URL and the value is "".
rel	String	Its value is self, indicating that href is a local link.

Example normal response

{
  "version": {
    "id": "v1",
    "links": [],
    "status": "DEPRECATED",
    "updated": "2017-02-07T17:34:02Z"
  },
  "versions": {
    "id": "v1",
    "links": [],
    "status": "DEPRECATED",
    "updated": "2017-02-07T17:34:02Z"
  }
}