Updated on 2024-04-11 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

  • Example

    https://{Endpoint}/rds

  • Parameter description

    None

Request

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.

    The value CURRENT indicates that the version has been released.

    updated

    String

    Indicates the version update time.

    The format is yyyy-mm-dd Thh:mm:ssZ.

    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.