Updated on 2024-01-12 GMT+08:00

Querying API Versions

Function

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

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

URI

  • URI format

    GET /rds

  • Parameter description

    None

Request

  • Request parameters

    None

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.

    • v3: indicates the API v3 version.

    links

    Array of objects

    Indicates the API link information. The value is empty when the version is v3.

    For details, see Table 3.

    status

    String

    Indicates the version status.

    • CURRENT: indicates that the version is recommended.

    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": "2017-02-07T17:34:02Z"
    	}
    	]
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.