Updated on 2025-06-19 GMT+08:00

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 Parameters

    Parameter

    Mandatory

    Description

    version

    Yes

    Explanation:

    API version.

    Constraints:

    N/A

    Value range:

    The value is case-sensitive.

    For details, see id in Table 2 in section Querying API Versions.

    Default value:

    N/A

Request

  • Request parameters

    None

Response

  • Normal response
    Table 2 Parameters

    Parameter

    Type

    Description

    versions

    Object

    Explanation:

    API version details.

    For details, see Table 3.

    version

    Object

    Explanation:

    API version details.

    For details, see Table 3.

    Table 3 versions field data structure description

    Parameter

    Type

    Description

    id

    String

    Explanation:

    API version.

    Value range:

    N/A

    links

    Array

    Explanation:

    API version link information. Its value is empty.

    For details, see Table 4.

    status

    String

    Explanation:

    Version status.

    Value range:

    N/A

    updated

    String

    Explanation:

    Version update time.

    Value range:

    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 UTC.

    Table 4 links field data structure description

    Parameter

    Type

    Description

    href

    String

    Explanation:

    URL of the API.

    Value range:

    The value is "".

    rel

    String

    Explanation:

    URL type.

    Value range:

    The value is self, indicating that href is a local link.

  • Example normal response
    {
      "version": {
        "id": "v3",
        "links": [],
        "status": "CURRENT",
        "updated": "2017-02-07T17:34:02Z"
      },
      "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.