Querying API Versions

Function

This API is used to query the supported RDS API versions.

This API will be unavailable on March 31, 2025. You are advised to switch workloads to the new API (Querying API Versions) before then.

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

URI

URI format
GET /rds
Parameter description
None

Request

Request parameters
None

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

Response

Normal response

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

**Table 2** versions field data structure description
Name	Type	Description
id	String	Indicates the API version. v1: indicates the API v1 version. v3: indicates the API v3 version.
links	Array of objects	Indicates the API link information. The value is empty when the version is v1 or v3. For details, see Table 3.
status	String	Indicates the version status. CURRENT: indicates that the version is recommended. DEPRECATED: indicates a deprecated version which may be deleted later.
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 Coordinated Universal Time (UTC).

**Table 3** 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

{
	"versions": [{
			"id": "v3",
			"links": [],
			"status": "CURRENT",
			"updated": "2019-01-15T12:00:00Z"
		},
		{
			"id": "v1",
			"links": [],
			"status": "DEPRECATED",
			"updated": "2017-02-07T17:34:02Z"
		}
	]
}